@agentxm/client-core 0.21.0 → 0.22.0

package/site-content/__generated__/schemas/files.schema.json

@@ -457,6 +457,63 @@
             { "type": "null" }
           ]
         },
+        "enhances": {
+          "anyOf": [
+            {
+              "type": "array",
+              "allOf": [
+                {
+                  "uniqueItems": true,
+                  "description": "Soft capability enhancements used by the source. These never block installation."
+                }
+              ],
+              "items": {
+                "type": "string",
+                "allOf": [
+                  { "minLength": 1 },
+                  {
+                    "pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?(?::[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)?$"
+                  }
+                ]
+              }
+            },
+            { "type": "null" }
+          ]
+        },
+        "requires": {
+          "anyOf": [
+            {
+              "type": "array",
+              "allOf": [
+                {
+                  "uniqueItems": true,
+                  "description": "Hard capabilities without which the extension cannot operate."
+                }
+              ],
+              "items": {
+                "type": "string",
+                "allOf": [
+                  { "minLength": 1 },
+                  {
+                    "pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?(?::[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)?$"
+                  }
+                ]
+              }
+            },
+            { "type": "null" }
+          ]
+        },
+        "fallback": {
+          "anyOf": [
+            {
+              "type": "string",
+              "enum": ["auto", "none"],
+              "description": "Whether AXM may apply platform-provided capability fallbacks. Defaults to auto.",
+              "default": "auto"
+            },
+            { "type": "null" }
+          ]
+        },
         "recommendedPacks": {
           "anyOf": [
             {

package/site-content/__generated__/schemas/hook.schema.json

@@ -470,6 +470,63 @@
             { "type": "null" }
           ]
         },
+        "enhances": {
+          "anyOf": [
+            {
+              "type": "array",
+              "allOf": [
+                {
+                  "uniqueItems": true,
+                  "description": "Soft capability enhancements used by the source. These never block installation."
+                }
+              ],
+              "items": {
+                "type": "string",
+                "allOf": [
+                  { "minLength": 1 },
+                  {
+                    "pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?(?::[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)?$"
+                  }
+                ]
+              }
+            },
+            { "type": "null" }
+          ]
+        },
+        "requires": {
+          "anyOf": [
+            {
+              "type": "array",
+              "allOf": [
+                {
+                  "uniqueItems": true,
+                  "description": "Hard capabilities without which the extension cannot operate."
+                }
+              ],
+              "items": {
+                "type": "string",
+                "allOf": [
+                  { "minLength": 1 },
+                  {
+                    "pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?(?::[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)?$"
+                  }
+                ]
+              }
+            },
+            { "type": "null" }
+          ]
+        },
+        "fallback": {
+          "anyOf": [
+            {
+              "type": "string",
+              "enum": ["auto", "none"],
+              "description": "Whether AXM may apply platform-provided capability fallbacks. Defaults to auto.",
+              "default": "auto"
+            },
+            { "type": "null" }
+          ]
+        },
         "recommendedPacks": {
           "anyOf": [
             {

package/site-content/__generated__/schemas/knowledge.schema.json

@@ -0,0 +1,365 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/KnowledgeManifest",
+  "definitions": {
+    "Handle": {
+      "type": "string",
+      "allOf": [
+        {
+          "pattern": "^@[a-z0-9_](?:[a-z0-9_-]*[a-z0-9_])?$",
+          "title": "Handle",
+          "description": "A unique username or organization name starting with @, like @my-org.",
+          "examples": ["@my-org", "@username"]
+        }
+      ]
+    },
+    "Version": {
+      "type": "string",
+      "allOf": [
+        {
+          "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$",
+          "title": "Version",
+          "description": "A semver version like 1.0.0. Ranges are not allowed here.",
+          "examples": ["1.0.0", "2.3.1", "0.1.0-beta.1"]
+        }
+      ]
+    },
+    "Repository": {
+      "anyOf": [
+        {
+          "type": "string",
+          "examples": ["https://github.com/acme/code-review", "github:acme/code-review"],
+          "format": "uri-reference"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "allOf": [
+                    {
+                      "minLength": 1,
+                      "description": "Version control system (e.g., `git`).",
+                      "examples": ["git"]
+                    }
+                  ]
+                },
+                { "type": "null" }
+              ]
+            },
+            "url": {
+              "type": "string",
+              "allOf": [
+                {
+                  "minLength": 1,
+                  "description": "Repository URL.",
+                  "examples": ["https://github.com/acme/code-review"],
+                  "format": "uri"
+                }
+              ]
+            },
+            "directory": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "allOf": [
+                    {
+                      "minLength": 1,
+                      "description": "Subdirectory within the repository, for monorepo publishers.",
+                      "examples": ["packages/code-review"]
+                    }
+                  ]
+                },
+                { "type": "null" }
+              ]
+            }
+          },
+          "required": ["url"],
+          "additionalProperties": false
+        }
+      ],
+      "title": "Repository",
+      "description": "Source repository for this extension. Accepts a URL string (or `host:owner/repo` shorthand) or an object with `type`, `url`, and optional `directory`."
+    },
+    "Bugs": {
+      "anyOf": [
+        {
+          "type": "string",
+          "examples": ["https://github.com/acme/code-review/issues"],
+          "format": "uri"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "url": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "allOf": [
+                    {
+                      "minLength": 1,
+                      "description": "Issue tracker URL.",
+                      "examples": ["https://github.com/acme/code-review/issues"],
+                      "format": "uri"
+                    }
+                  ]
+                },
+                { "type": "null" }
+              ]
+            },
+            "email": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "allOf": [
+                    {
+                      "minLength": 1,
+                      "description": "Contact email for bug reports.",
+                      "examples": ["bugs@acme.dev"],
+                      "format": "email"
+                    }
+                  ]
+                },
+                { "type": "null" }
+              ]
+            }
+          },
+          "additionalProperties": false
+        }
+      ],
+      "title": "Bugs",
+      "description": "Where to report bugs against this extension. Accepts a URL string or an object with optional `url` and `email`."
+    },
+    "Author": {
+      "type": "object",
+      "properties": {
+        "name": { "type": "string" },
+        "email": { "anyOf": [{ "type": "string" }, { "type": "null" }] },
+        "url": { "anyOf": [{ "type": "string" }, { "type": "null" }] }
+      },
+      "required": ["name"],
+      "additionalProperties": false,
+      "title": "Author",
+      "description": "A person credited as a creator or maintainer of this extension."
+    },
+    "PackageIdentityPurl": {
+      "type": "string",
+      "allOf": [
+        { "minLength": 1 },
+        {
+          "pattern": "^[Pp][Kk][Gg]:[a-zA-Z][a-zA-Z0-9.+-]*\\/.+$",
+          "title": "Package Identity Purl",
+          "description": "A Package URL (purl) identity for a companion package. Companion package purls are identities, not pins: omit the purl @version segment and put compatibility constraints in versionRange.",
+          "examples": ["pkg:npm/react", "pkg:pypi/requests", "pkg:cargo/serde"]
+        }
+      ]
+    },
+    "VersRange": {
+      "type": "string",
+      "allOf": [
+        {
+          "minLength": 1,
+          "examples": ["vers:npm/>=18.0.0|<19.0.0", "vers:pypi/>=2.31.0", "vers:cargo/>=1.0.0"]
+        }
+      ]
+    },
+    "CompanionPackage": {
+      "type": "object",
+      "properties": {
+        "purl": { "$ref": "#/definitions/PackageIdentityPurl" },
+        "versionRange": { "anyOf": [{ "$ref": "#/definitions/VersRange" }, { "type": "null" }] }
+      },
+      "required": ["purl"],
+      "additionalProperties": false,
+      "title": "Companion Package",
+      "description": "A companion package purl identity with an optional VERS compatibility range."
+    },
+    "PackSpec": {
+      "type": "string",
+      "allOf": [
+        { "minLength": 1 },
+        {
+          "pattern": "^(@[a-z0-9_](?:[a-z0-9_-]*[a-z0-9_])?)\\/packs\\/([a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?)(?:@.+)?$",
+          "title": "Pack Spec",
+          "description": "Pack reference with an optional version constraint suffix.",
+          "examples": ["@acme/packs/typescript", "@acme/packs/typescript@^1.0.0"]
+        }
+      ]
+    },
+    "ExtensionName": {
+      "type": "string",
+      "allOf": [
+        { "minLength": 1 },
+        {
+          "pattern": "^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$",
+          "title": "Extension Name",
+          "description": "Short bundle name. Combined with owner, forms the FQN @owner/knowledge/<name>.",
+          "examples": ["my-skill", "code-review", "prettier"]
+        }
+      ]
+    },
+    "KnowledgeManifest": {
+      "type": "object",
+      "properties": {
+        "$schema": { "anyOf": [{ "type": "string" }, { "type": "null" }] },
+        "owner": { "$ref": "#/definitions/Handle" },
+        "version": { "$ref": "#/definitions/Version" },
+        "description": {
+          "anyOf": [
+            {
+              "type": "string",
+              "description": "Short, registry-facing summary of this extension shown in listings and search results."
+            },
+            { "type": "null" }
+          ]
+        },
+        "keywords": {
+          "anyOf": [
+            {
+              "type": "array",
+              "examples": [["lint", "typescript", "review"]],
+              "items": { "type": "string", "allOf": [{ "minLength": 1 }] }
+            },
+            { "type": "null" }
+          ]
+        },
+        "repository": { "anyOf": [{ "$ref": "#/definitions/Repository" }, { "type": "null" }] },
+        "homepage": {
+          "anyOf": [
+            { "type": "string", "examples": ["https://acme.dev/code-review"], "format": "uri" },
+            { "type": "null" }
+          ]
+        },
+        "license": {
+          "anyOf": [
+            {
+              "type": "string",
+              "title": "License",
+              "description": "SPDX license expression, or `UNLICENSED` for proprietary code.",
+              "examples": ["MIT", "Apache-2.0", "MIT OR Apache-2.0", "UNLICENSED"],
+              "format": "spdx-expression"
+            },
+            { "type": "null" }
+          ]
+        },
+        "bugs": { "anyOf": [{ "$ref": "#/definitions/Bugs" }, { "type": "null" }] },
+        "authors": {
+          "anyOf": [
+            { "type": "array", "items": { "$ref": "#/definitions/Author" } },
+            { "type": "null" }
+          ]
+        },
+        "packages": {
+          "anyOf": [
+            {
+              "type": "array",
+              "description": "External ecosystem packages this extension is designed to work with, declared as identity Package URLs with optional VERS compatibility ranges.",
+              "items": { "$ref": "#/definitions/CompanionPackage" }
+            },
+            { "type": "null" }
+          ]
+        },
+        "enhances": {
+          "anyOf": [
+            {
+              "type": "array",
+              "allOf": [
+                {
+                  "uniqueItems": true,
+                  "description": "Soft capability enhancements used by the source. These never block installation."
+                }
+              ],
+              "items": {
+                "type": "string",
+                "allOf": [
+                  { "minLength": 1 },
+                  {
+                    "pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?(?::[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)?$"
+                  }
+                ]
+              }
+            },
+            { "type": "null" }
+          ]
+        },
+        "requires": {
+          "anyOf": [
+            {
+              "type": "array",
+              "allOf": [
+                {
+                  "uniqueItems": true,
+                  "description": "Hard capabilities without which the extension cannot operate."
+                }
+              ],
+              "items": {
+                "type": "string",
+                "allOf": [
+                  { "minLength": 1 },
+                  {
+                    "pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?(?::[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)?$"
+                  }
+                ]
+              }
+            },
+            { "type": "null" }
+          ]
+        },
+        "fallback": {
+          "anyOf": [
+            {
+              "type": "string",
+              "enum": ["auto", "none"],
+              "description": "Whether AXM may apply platform-provided capability fallbacks. Defaults to auto.",
+              "default": "auto"
+            },
+            { "type": "null" }
+          ]
+        },
+        "recommendedPacks": {
+          "anyOf": [
+            {
+              "type": "array",
+              "description": "Packs this extension is designed to work alongside. Each entry is a pack spec, optionally pinned to a version range.",
+              "items": { "$ref": "#/definitions/PackSpec" }
+            },
+            { "type": "null" }
+          ]
+        },
+        "standalone": {
+          "anyOf": [
+            {
+              "type": "boolean",
+              "description": "Set to false to indicate this extension only makes sense when installed alongside one of its recommendedPacks.",
+              "default": true
+            },
+            { "type": "null" }
+          ]
+        },
+        "type": { "type": "string", "enum": ["knowledge"] },
+        "format": {
+          "type": "object",
+          "properties": {
+            "name": { "type": "string", "enum": ["okf"] },
+            "version": { "type": "string", "enum": ["0.1"] }
+          },
+          "required": ["name", "version"],
+          "additionalProperties": false,
+          "description": "Open Knowledge Format dialect and version used by this bundle."
+        },
+        "bundleRoot": {
+          "type": "string",
+          "enum": ["src"],
+          "description": "Package-relative directory containing the authoritative OKF bundle."
+        },
+        "name": { "$ref": "#/definitions/ExtensionName" }
+      },
+      "required": ["owner", "version", "type", "format", "bundleRoot", "name"],
+      "additionalProperties": false,
+      "title": "Knowledge Manifest",
+      "description": "Manifest for an isolated Open Knowledge Format 0.1 draft bundle rooted at src/."
+    }
+  }
+}

package/site-content/__generated__/schemas/mcp.schema.json

@@ -641,6 +641,63 @@
             { "type": "null" }
           ]
         },
+        "enhances": {
+          "anyOf": [
+            {
+              "type": "array",
+              "allOf": [
+                {
+                  "uniqueItems": true,
+                  "description": "Soft capability enhancements used by the source. These never block installation."
+                }
+              ],
+              "items": {
+                "type": "string",
+                "allOf": [
+                  { "minLength": 1 },
+                  {
+                    "pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?(?::[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)?$"
+                  }
+                ]
+              }
+            },
+            { "type": "null" }
+          ]
+        },
+        "requires": {
+          "anyOf": [
+            {
+              "type": "array",
+              "allOf": [
+                {
+                  "uniqueItems": true,
+                  "description": "Hard capabilities without which the extension cannot operate."
+                }
+              ],
+              "items": {
+                "type": "string",
+                "allOf": [
+                  { "minLength": 1 },
+                  {
+                    "pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?(?::[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)?$"
+                  }
+                ]
+              }
+            },
+            { "type": "null" }
+          ]
+        },
+        "fallback": {
+          "anyOf": [
+            {
+              "type": "string",
+              "enum": ["auto", "none"],
+              "description": "Whether AXM may apply platform-provided capability fallbacks. Defaults to auto.",
+              "default": "auto"
+            },
+            { "type": "null" }
+          ]
+        },
         "recommendedPacks": {
           "anyOf": [
             {

package/site-content/__generated__/schemas/pack.schema.json

@@ -204,7 +204,7 @@
       "type": "string",
       "allOf": [
         {
-          "pattern": "^(@[a-z0-9_](?:[a-z0-9_-]*[a-z0-9_])?)\\/(skills|commands|mcps|subagents|files|rules|hooks)\\/([a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?)$",
+          "pattern": "^(@[a-z0-9_](?:[a-z0-9_-]*[a-z0-9_])?)\\/(skills|commands|mcps|subagents|files|rules|hooks|knowledge)\\/([a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?)$",
           "title": "Non-Pack Extension FQN",
           "description": "Extension identifier restricted to non-pack types (skills, commands, mcps, subagents, context, rules, hooks).",
           "examples": ["@acme/skills/code-review", "@my-org/commands/format"]

package/site-content/__generated__/schemas/rule.schema.json

@@ -261,6 +261,63 @@
             { "type": "null" }
           ]
         },
+        "enhances": {
+          "anyOf": [
+            {
+              "type": "array",
+              "allOf": [
+                {
+                  "uniqueItems": true,
+                  "description": "Soft capability enhancements used by the source. These never block installation."
+                }
+              ],
+              "items": {
+                "type": "string",
+                "allOf": [
+                  { "minLength": 1 },
+                  {
+                    "pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?(?::[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)?$"
+                  }
+                ]
+              }
+            },
+            { "type": "null" }
+          ]
+        },
+        "requires": {
+          "anyOf": [
+            {
+              "type": "array",
+              "allOf": [
+                {
+                  "uniqueItems": true,
+                  "description": "Hard capabilities without which the extension cannot operate."
+                }
+              ],
+              "items": {
+                "type": "string",
+                "allOf": [
+                  { "minLength": 1 },
+                  {
+                    "pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?(?::[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)?$"
+                  }
+                ]
+              }
+            },
+            { "type": "null" }
+          ]
+        },
+        "fallback": {
+          "anyOf": [
+            {
+              "type": "string",
+              "enum": ["auto", "none"],
+              "description": "Whether AXM may apply platform-provided capability fallbacks. Defaults to auto.",
+              "default": "auto"
+            },
+            { "type": "null" }
+          ]
+        },
         "recommendedPacks": {
           "anyOf": [
             {