@agentxm/client-core 0.5.1 → 0.5.2

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

@@ -13,7 +13,17 @@
         }
       ]
     },
-    "ExactSemverVersion": { "type": "string" },
+    "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"]
+        }
+      ]
+    },
     "Author": {
       "type": "object",
       "properties": {
@@ -24,24 +34,100 @@
       "required": ["name"],
       "additionalProperties": false,
       "title": "Author",
-      "description": "Author details: name, email, and URL."
+      "description": "A person credited as a creator or maintainer of this extension."
+    },
+    "PackageUrl": {
+      "type": "string",
+      "allOf": [
+        {
+          "pattern": "^[Pp][Kk][Gg]:[a-zA-Z][a-zA-Z0-9.+-]*\\/.+$",
+          "title": "Package URL",
+          "description": "A Package URL (purl) string identifying a package across ecosystems (e.g. pkg:npm/react@18.2.0).",
+          "examples": ["pkg:npm/react@18.2.0", "pkg:pypi/requests@2.31.0", "pkg:cargo/serde@1.0"]
+        }
+      ]
+    },
+    "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 name for this command within its owner namespace. Combined with owner, forms the FQN @owner/commands/<name>.",
+          "examples": ["my-skill", "code-review", "prettier"]
+        }
+      ]
     },
-    "PackageUrlParts": { "type": "string" },
-    "ExtensionName": { "type": "string" },
     "CommandManifest": {
       "type": "object",
       "properties": {
         "$schema": { "anyOf": [{ "type": "string" }, { "type": "null" }] },
         "owner": { "$ref": "#/definitions/Handle" },
-        "version": { "$ref": "#/definitions/ExactSemverVersion" },
-        "description": { "anyOf": [{ "type": "string" }, { "type": "null" }] },
+        "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", "items": { "type": "string" } }, { "type": "null" }]
+          "anyOf": [
+            {
+              "type": "array",
+              "examples": [["lint", "typescript", "review"]],
+              "items": { "type": "string", "allOf": [{ "minLength": 1 }] }
+            },
+            { "type": "null" }
+          ]
+        },
+        "repository": {
+          "anyOf": [
+            {
+              "type": "string",
+              "examples": ["https://github.com/acme/code-review"],
+              "format": "uri"
+            },
+            { "type": "null" }
+          ]
+        },
+        "homepage": {
+          "anyOf": [
+            { "type": "string", "examples": ["https://acme.dev/code-review"], "format": "uri" },
+            { "type": "null" }
+          ]
+        },
+        "license": {
+          "anyOf": [
+            { "type": "string", "allOf": [{ "minLength": 1, "examples": ["MIT", "Apache-2.0"] }] },
+            { "type": "null" }
+          ]
+        },
+        "bugs": {
+          "anyOf": [
+            {
+              "type": "string",
+              "examples": ["https://github.com/acme/code-review/issues"],
+              "format": "uri"
+            },
+            { "type": "null" }
+          ]
         },
-        "repository": { "anyOf": [{ "type": "string" }, { "type": "null" }] },
-        "homepage": { "anyOf": [{ "type": "string" }, { "type": "null" }] },
-        "license": { "anyOf": [{ "type": "string" }, { "type": "null" }] },
-        "bugs": { "anyOf": [{ "type": "string" }, { "type": "null" }] },
         "authors": {
           "anyOf": [
             { "type": "array", "items": { "$ref": "#/definitions/Author" } },
@@ -50,23 +136,41 @@
         },
         "compatiblePackages": {
           "anyOf": [
-            { "type": "array", "items": { "$ref": "#/definitions/PackageUrlParts" } },
+            {
+              "type": "array",
+              "description": "External ecosystem packages this extension targets (e.g. the npm or PyPI package an MCP server wraps), identified by Package URL (purl).",
+              "items": { "$ref": "#/definitions/PackageUrl" }
+            },
             { "type": "null" }
           ]
         },
-        "type": { "type": "string", "enum": ["command"] },
-        "name": { "$ref": "#/definitions/ExtensionName" },
-        "agentOverrides": {
+        "recommendedPacks": {
           "anyOf": [
-            { "type": "object", "additionalProperties": { "type": "object" } },
+            {
+              "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": ["command"] },
+        "name": { "$ref": "#/definitions/ExtensionName" }
       },
       "required": ["owner", "version", "type", "name"],
       "additionalProperties": false,
       "title": "Command Manifest",
-      "description": "Configuration file (command.json) that defines a CLI command extension."
+      "description": "Extension manifest file for slash-command. Carries registry-facing identity, version, and metadata. Per-agent frontmatter overrides live in the content file."
     }
   }
 }

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

@@ -13,7 +13,17 @@
         }
       ]
     },
-    "ExactSemverVersion": { "type": "string" },
+    "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"]
+        }
+      ]
+    },
     "Author": {
       "type": "object",
       "properties": {
@@ -24,24 +34,100 @@
       "required": ["name"],
       "additionalProperties": false,
       "title": "Author",
-      "description": "Author details: name, email, and URL."
+      "description": "A person credited as a creator or maintainer of this extension."
+    },
+    "PackageUrl": {
+      "type": "string",
+      "allOf": [
+        {
+          "pattern": "^[Pp][Kk][Gg]:[a-zA-Z][a-zA-Z0-9.+-]*\\/.+$",
+          "title": "Package URL",
+          "description": "A Package URL (purl) string identifying a package across ecosystems (e.g. pkg:npm/react@18.2.0).",
+          "examples": ["pkg:npm/react@18.2.0", "pkg:pypi/requests@2.31.0", "pkg:cargo/serde@1.0"]
+        }
+      ]
+    },
+    "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 name for this MCP server within its owner namespace. Combined with owner, forms the FQN @owner/mcp-servers/<name>.",
+          "examples": ["my-skill", "code-review", "prettier"]
+        }
+      ]
     },
-    "PackageUrlParts": { "type": "string" },
-    "ExtensionName": { "type": "string" },
     "McpServerManifest": {
       "type": "object",
       "properties": {
         "$schema": { "anyOf": [{ "type": "string" }, { "type": "null" }] },
         "owner": { "$ref": "#/definitions/Handle" },
-        "version": { "$ref": "#/definitions/ExactSemverVersion" },
-        "description": { "anyOf": [{ "type": "string" }, { "type": "null" }] },
+        "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", "items": { "type": "string" } }, { "type": "null" }]
+          "anyOf": [
+            {
+              "type": "array",
+              "examples": [["lint", "typescript", "review"]],
+              "items": { "type": "string", "allOf": [{ "minLength": 1 }] }
+            },
+            { "type": "null" }
+          ]
+        },
+        "repository": {
+          "anyOf": [
+            {
+              "type": "string",
+              "examples": ["https://github.com/acme/code-review"],
+              "format": "uri"
+            },
+            { "type": "null" }
+          ]
+        },
+        "homepage": {
+          "anyOf": [
+            { "type": "string", "examples": ["https://acme.dev/code-review"], "format": "uri" },
+            { "type": "null" }
+          ]
+        },
+        "license": {
+          "anyOf": [
+            { "type": "string", "allOf": [{ "minLength": 1, "examples": ["MIT", "Apache-2.0"] }] },
+            { "type": "null" }
+          ]
+        },
+        "bugs": {
+          "anyOf": [
+            {
+              "type": "string",
+              "examples": ["https://github.com/acme/code-review/issues"],
+              "format": "uri"
+            },
+            { "type": "null" }
+          ]
         },
-        "repository": { "anyOf": [{ "type": "string" }, { "type": "null" }] },
-        "homepage": { "anyOf": [{ "type": "string" }, { "type": "null" }] },
-        "license": { "anyOf": [{ "type": "string" }, { "type": "null" }] },
-        "bugs": { "anyOf": [{ "type": "string" }, { "type": "null" }] },
         "authors": {
           "anyOf": [
             { "type": "array", "items": { "$ref": "#/definitions/Author" } },
@@ -50,7 +136,31 @@
         },
         "compatiblePackages": {
           "anyOf": [
-            { "type": "array", "items": { "$ref": "#/definitions/PackageUrlParts" } },
+            {
+              "type": "array",
+              "description": "External ecosystem packages this extension targets (e.g. the npm or PyPI package an MCP server wraps), identified by Package URL (purl).",
+              "items": { "$ref": "#/definitions/PackageUrl" }
+            },
+            { "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" }
           ]
         },
@@ -60,7 +170,7 @@
       "required": ["owner", "version", "type", "name"],
       "additionalProperties": false,
       "title": "MCP Server Manifest",
-      "description": "Configuration file (mcp-server.json) that defines an MCP server extension."
+      "description": "Extension manifest file for MCP server. Registers a Model Context Protocol server that coding agents can connect to for additional tools and resources."
     }
   }
 }

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

@@ -0,0 +1,173 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/PackManifest",
+  "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"]
+        }
+      ]
+    },
+    "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."
+    },
+    "PackageUrl": {
+      "type": "string",
+      "allOf": [
+        {
+          "pattern": "^[Pp][Kk][Gg]:[a-zA-Z][a-zA-Z0-9.+-]*\\/.+$",
+          "title": "Package URL",
+          "description": "A Package URL (purl) string identifying a package across ecosystems (e.g. pkg:npm/react@18.2.0).",
+          "examples": ["pkg:npm/react@18.2.0", "pkg:pypi/requests@2.31.0", "pkg:cargo/serde@1.0"]
+        }
+      ]
+    },
+    "ExtensionName": {
+      "type": "string",
+      "allOf": [
+        { "minLength": 1 },
+        {
+          "pattern": "^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$",
+          "title": "Extension Name",
+          "description": "Short name for this pack within its owner namespace. Combined with owner, forms the FQN @owner/packs/<name>.",
+          "examples": ["my-skill", "code-review", "prettier"]
+        }
+      ]
+    },
+    "NonPackExtensionFqn": {
+      "type": "string",
+      "allOf": [
+        {
+          "pattern": "^(@[a-z0-9_](?:[a-z0-9_-]*[a-z0-9_])?)\\/(skills|commands|mcp-servers|subagents|files|rules)\\/([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, mcp-servers, subagents, files, rules).",
+          "examples": ["@acme/skills/code-review", "@my-org/commands/format"]
+        }
+      ]
+    },
+    "VersionRange": {
+      "type": "string",
+      "allOf": [
+        { "minLength": 1 },
+        {
+          "pattern": "^[~^<>=*xXvV0-9A-Za-z| .-]+$",
+          "title": "Version Range",
+          "description": "A semver version range like ^1.0.0, ~2.3.0, >=1.0.0 <3.0.0, or an exact version 1.2.3. Use \"*\" to always resolve to the latest available version.",
+          "examples": ["^1.0.0", "~2.4", ">=1 <3", "1.2.3", "*"]
+        }
+      ]
+    },
+    "PackManifest": {
+      "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": [
+            {
+              "type": "string",
+              "examples": ["https://github.com/acme/code-review"],
+              "format": "uri"
+            },
+            { "type": "null" }
+          ]
+        },
+        "homepage": {
+          "anyOf": [
+            { "type": "string", "examples": ["https://acme.dev/code-review"], "format": "uri" },
+            { "type": "null" }
+          ]
+        },
+        "license": {
+          "anyOf": [
+            { "type": "string", "allOf": [{ "minLength": 1, "examples": ["MIT", "Apache-2.0"] }] },
+            { "type": "null" }
+          ]
+        },
+        "bugs": {
+          "anyOf": [
+            {
+              "type": "string",
+              "examples": ["https://github.com/acme/code-review/issues"],
+              "format": "uri"
+            },
+            { "type": "null" }
+          ]
+        },
+        "authors": {
+          "anyOf": [
+            { "type": "array", "items": { "$ref": "#/definitions/Author" } },
+            { "type": "null" }
+          ]
+        },
+        "compatiblePackages": {
+          "anyOf": [
+            {
+              "type": "array",
+              "description": "External ecosystem packages this extension targets (e.g. the npm or PyPI package an MCP server wraps), identified by Package URL (purl).",
+              "items": { "$ref": "#/definitions/PackageUrl" }
+            },
+            { "type": "null" }
+          ]
+        },
+        "type": { "type": "string", "enum": ["pack"] },
+        "name": { "$ref": "#/definitions/ExtensionName" },
+        "dependencies": {
+          "type": "object",
+          "description": "Map of fully-qualified non-pack extension names to version ranges. Packs cannot depend on other packs.",
+          "propertyNames": { "$ref": "#/definitions/NonPackExtensionFqn" },
+          "additionalProperties": { "$ref": "#/definitions/VersionRange" }
+        }
+      },
+      "required": ["owner", "version", "type", "name", "dependencies"],
+      "additionalProperties": false,
+      "title": "Pack Manifest",
+      "description": "Extension manifest file for extension packs. Bundles a curated set of skills, commands, MCP servers, subagents, files, and rules into a single installable unit."
+    }
+  }
+}