@agentxm/client-core 0.5.1 → 0.5.3

package/site-content/__generated__/schemas/axm-lock.schema.json

@@ -15,34 +15,70 @@
         }
       ]
     },
-    "ExtensionName": { "type": "string" },
-    "ExactSemverVersion": { "type": "string" },
-    "ExtensionPackLockEntry": {
+    "ExtensionName": {
+      "type": "string",
+      "allOf": [
+        { "minLength": 1 },
+        {
+          "pattern": "^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$",
+          "title": "Extension Name",
+          "description": "The name of an extension — lowercase letters, numbers, and hyphens (e.g. my-skill).",
+          "examples": ["my-skill", "code-review", "prettier"]
+        }
+      ]
+    },
+    "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"]
+        }
+      ]
+    },
+    "ExtensionFqn": {
+      "type": "string",
+      "allOf": [
+        {
+          "pattern": "^(@[a-z0-9_](?:[a-z0-9_-]*[a-z0-9_])?)\\/(skills|commands|mcp-servers|subagents|files|rules|packs)\\/([a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?)$",
+          "title": "Extension FQN",
+          "description": "Canonical extension identifier in @owner/<type>s/<name> form.",
+          "examples": ["@acme/skills/code-review", "@my-org/commands/format"]
+        }
+      ]
+    },
+    "PackLockEntry": {
       "type": "object",
       "properties": {
         "type": { "type": "string", "enum": ["registry"] },
         "owner": { "$ref": "#/definitions/Handle" },
         "name": { "$ref": "#/definitions/ExtensionName" },
-        "resolvedVersion": { "$ref": "#/definitions/ExactSemverVersion" },
+        "resolvedVersion": { "$ref": "#/definitions/Version" },
         "integrity": { "type": "string" },
         "sourceName": { "type": "string" },
         "installedAt": { "$ref": "#/definitions/IsoDateTimeString" },
         "updatedAt": { "$ref": "#/definitions/IsoDateTimeString" },
         "resolvedSkills": {
           "type": "object",
-          "additionalProperties": { "$ref": "#/definitions/ExactSemverVersion" }
+          "propertyNames": { "$ref": "#/definitions/ExtensionFqn" },
+          "additionalProperties": { "$ref": "#/definitions/Version" }
         },
         "resolvedCommands": {
           "type": "object",
-          "additionalProperties": { "$ref": "#/definitions/ExactSemverVersion" }
+          "propertyNames": { "$ref": "#/definitions/ExtensionFqn" },
+          "additionalProperties": { "$ref": "#/definitions/Version" }
         },
         "resolvedMcpServers": {
           "type": "object",
-          "additionalProperties": { "$ref": "#/definitions/ExactSemverVersion" }
+          "propertyNames": { "$ref": "#/definitions/ExtensionFqn" },
+          "additionalProperties": { "$ref": "#/definitions/Version" }
         },
         "resolvedSubagents": {
           "type": "object",
-          "additionalProperties": { "$ref": "#/definitions/ExactSemverVersion" }
+          "propertyNames": { "$ref": "#/definitions/ExtensionFqn" },
+          "additionalProperties": { "$ref": "#/definitions/Version" }
         }
       },
       "required": [
@@ -60,18 +96,16 @@
         "resolvedSubagents"
       ],
       "additionalProperties": false,
-      "title": "Extension Pack Lock Entry",
-      "description": "Pinned version info for an installed extension pack from a registry."
+      "title": "Pack Lock Entry",
+      "description": "Pinned version info for an installed pack from a registry."
     },
     "Lockfile": {
       "type": "object",
       "properties": {
         "lockfileVersion": {
-          "anyOf": [
-            { "type": "number" },
-            { "type": "string", "enum": ["NaN"] },
-            { "type": "string", "enum": ["Infinity"] },
-            { "type": "string", "enum": ["-Infinity"] }
+          "type": "integer",
+          "allOf": [
+            { "minimum": 1, "description": "Lockfile schema version (currently 1).", "default": 1 }
           ]
         },
         "skills": {
@@ -349,7 +383,7 @@
                   "type": { "type": "string", "enum": ["registry"] },
                   "owner": { "$ref": "#/definitions/Handle" },
                   "name": { "$ref": "#/definitions/ExtensionName" },
-                  "resolvedVersion": { "$ref": "#/definitions/ExactSemverVersion" },
+                  "resolvedVersion": { "$ref": "#/definitions/Version" },
                   "integrity": { "type": "string" },
                   "sourceName": { "type": "string" },
                   "agents": { "type": "array", "items": { "type": "string" } },
@@ -669,7 +703,7 @@
                       "type": { "type": "string", "enum": ["registry"] },
                       "owner": { "$ref": "#/definitions/Handle" },
                       "name": { "$ref": "#/definitions/ExtensionName" },
-                      "resolvedVersion": { "$ref": "#/definitions/ExactSemverVersion" },
+                      "resolvedVersion": { "$ref": "#/definitions/Version" },
                       "integrity": { "type": "string" },
                       "sourceName": { "type": "string" },
                       "agents": { "type": "array", "items": { "type": "string" } },
@@ -992,7 +1026,7 @@
                       "type": { "type": "string", "enum": ["registry"] },
                       "owner": { "$ref": "#/definitions/Handle" },
                       "name": { "$ref": "#/definitions/ExtensionName" },
-                      "resolvedVersion": { "$ref": "#/definitions/ExactSemverVersion" },
+                      "resolvedVersion": { "$ref": "#/definitions/Version" },
                       "integrity": { "type": "string" },
                       "sourceName": { "type": "string" },
                       "agents": { "type": "array", "items": { "type": "string" } },
@@ -1200,7 +1234,7 @@
                       "type": { "type": "string", "enum": ["registry"] },
                       "owner": { "$ref": "#/definitions/Handle" },
                       "name": { "$ref": "#/definitions/ExtensionName" },
-                      "resolvedVersion": { "$ref": "#/definitions/ExactSemverVersion" },
+                      "resolvedVersion": { "$ref": "#/definitions/Version" },
                       "integrity": { "type": "string" },
                       "sourceName": { "type": "string" },
                       "installedAt": { "$ref": "#/definitions/IsoDateTimeString" },
@@ -1228,10 +1262,7 @@
         },
         "packs": {
           "anyOf": [
-            {
-              "type": "object",
-              "additionalProperties": { "$ref": "#/definitions/ExtensionPackLockEntry" }
-            },
+            { "type": "object", "additionalProperties": { "$ref": "#/definitions/PackLockEntry" } },
             { "type": "null" }
           ]
         }

package/site-content/__generated__/schemas/axm-package-meta.schema.json

@@ -2,14 +2,25 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$ref": "#/definitions/AxmPackageMeta",
   "definitions": {
-    "FullyQualifiedRef": { "type": "string" },
+    "ExtensionSpec": {
+      "type": "string",
+      "allOf": [
+        { "minLength": 1 },
+        {
+          "pattern": "^(@[a-z0-9_](?:[a-z0-9_-]*[a-z0-9_])?)\\/(skills|commands|mcp-servers|subagents|files|rules|packs)\\/([a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?)(?:@.+)?$",
+          "title": "Extension Spec",
+          "description": "Extension reference with an optional version constraint suffix.",
+          "examples": ["@acme/skills/code-review", "@acme/skills/code-review@^1.0.0"]
+        }
+      ]
+    },
     "AxmPackageMeta": {
       "type": "object",
       "properties": {
         "$schema": { "anyOf": [{ "type": "string" }, { "type": "null" }] },
         "recommendedExtensions": {
           "type": "array",
-          "items": { "$ref": "#/definitions/FullyQualifiedRef" }
+          "items": { "$ref": "#/definitions/ExtensionSpec" }
         }
       },
       "required": ["recommendedExtensions"],

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,49 +34,143 @@
       "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" } },
             { "type": "null" }
           ]
         },
-        "compatiblePackages": {
+        "companionPackages": {
           "anyOf": [
-            { "type": "array", "items": { "$ref": "#/definitions/PackageUrlParts" } },
+            {
+              "type": "array",
+              "description": "External ecosystem packages this extension is designed to work with (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,33 +34,133 @@
       "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" } },
             { "type": "null" }
           ]
         },
-        "compatiblePackages": {
+        "companionPackages": {
+          "anyOf": [
+            {
+              "type": "array",
+              "description": "External ecosystem packages this extension is designed to work with (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": "array", "items": { "$ref": "#/definitions/PackageUrlParts" } },
+            {
+              "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."
     }
   }
 }