@agentxm/client-core 0.5.1 → 0.5.3

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" }
+          ]
+        },
+        "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" }
+          ]
+        },
+        "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."
+    }
+  }
+}

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

@@ -98,9 +98,27 @@
     "CommandEntryObject": {
       "type": "object",
       "properties": {
-        "source": { "type": "string" },
-        "enabled": { "anyOf": [{ "type": "boolean" }, { "type": "null" }] },
-        "authored": { "anyOf": [{ "type": "boolean" }, { "type": "null" }] }
+        "source": { "type": "string", "allOf": [{ "minLength": 1 }] },
+        "enabled": {
+          "anyOf": [
+            {
+              "type": "boolean",
+              "description": "Whether this entry is enabled. Defaults to true when omitted.",
+              "default": true
+            },
+            { "type": "null" }
+          ]
+        },
+        "authored": {
+          "anyOf": [
+            {
+              "type": "boolean",
+              "description": "Whether this entry was authored locally. Defaults to false when omitted.",
+              "default": false
+            },
+            { "type": "null" }
+          ]
+        }
       },
       "required": ["source"],
       "additionalProperties": false,
@@ -112,14 +130,35 @@
     },
     "CommandsMap": {
       "type": "object",
+      "title": "Commands Map",
+      "description": "Your installed commands, keyed by name.",
+      "propertyNames": { "pattern": "^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$" },
       "additionalProperties": { "$ref": "#/definitions/CommandEntry" }
     },
     "SubagentEntryObject": {
       "type": "object",
       "properties": {
-        "source": { "type": "string" },
-        "enabled": { "anyOf": [{ "type": "boolean" }, { "type": "null" }] },
-        "authored": { "anyOf": [{ "type": "boolean" }, { "type": "null" }] }
+        "source": { "type": "string", "allOf": [{ "minLength": 1 }] },
+        "enabled": {
+          "anyOf": [
+            {
+              "type": "boolean",
+              "description": "Whether this entry is enabled. Defaults to true when omitted.",
+              "default": true
+            },
+            { "type": "null" }
+          ]
+        },
+        "authored": {
+          "anyOf": [
+            {
+              "type": "boolean",
+              "description": "Whether this entry was authored locally. Defaults to false when omitted.",
+              "default": false
+            },
+            { "type": "null" }
+          ]
+        }
       },
       "required": ["source"],
       "additionalProperties": false,
@@ -131,13 +170,25 @@
     },
     "SubagentsMap": {
       "type": "object",
+      "title": "Subagents Map",
+      "description": "Your installed subagents, keyed by name.",
+      "propertyNames": { "pattern": "^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$" },
       "additionalProperties": { "$ref": "#/definitions/SubagentEntry" }
     },
     "McpServerEntryObject": {
       "type": "object",
       "properties": {
-        "source": { "type": "string" },
-        "authored": { "anyOf": [{ "type": "boolean" }, { "type": "null" }] }
+        "source": { "type": "string", "allOf": [{ "minLength": 1 }] },
+        "authored": {
+          "anyOf": [
+            {
+              "type": "boolean",
+              "description": "Whether this entry was authored locally. Defaults to false when omitted.",
+              "default": false
+            },
+            { "type": "null" }
+          ]
+        }
       },
       "required": ["source"],
       "additionalProperties": false,
@@ -149,32 +200,63 @@
     },
     "McpServersMap": {
       "type": "object",
+      "title": "MCP Servers Map",
+      "description": "Your installed MCP servers, keyed by name.",
+      "propertyNames": { "pattern": "^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$" },
       "additionalProperties": { "$ref": "#/definitions/McpServerEntry" }
     },
-    "ExtensionPackEntryObject": {
+    "PackEntryObject": {
       "type": "object",
       "properties": {
-        "source": { "type": "string" },
-        "authored": { "anyOf": [{ "type": "boolean" }, { "type": "null" }] }
+        "source": { "type": "string", "allOf": [{ "minLength": 1 }] },
+        "authored": {
+          "anyOf": [
+            {
+              "type": "boolean",
+              "description": "Whether this entry was authored locally. Defaults to false when omitted.",
+              "default": false
+            },
+            { "type": "null" }
+          ]
+        }
       },
       "required": ["source"],
       "additionalProperties": false,
-      "title": "Extension Pack Entry Object",
-      "description": "An extension pack with its source location."
-    },
-    "ExtensionPackEntry": {
-      "anyOf": [{ "type": "string" }, { "$ref": "#/definitions/ExtensionPackEntryObject" }]
+      "title": "Pack Entry Object",
+      "description": "A pack with its source location."
     },
-    "ExtensionPacksMap": {
+    "PackEntry": { "anyOf": [{ "type": "string" }, { "$ref": "#/definitions/PackEntryObject" }] },
+    "PacksMap": {
       "type": "object",
-      "additionalProperties": { "$ref": "#/definitions/ExtensionPackEntry" }
+      "title": "Packs Map",
+      "description": "Your installed packs, keyed by name.",
+      "propertyNames": { "pattern": "^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$" },
+      "additionalProperties": { "$ref": "#/definitions/PackEntry" }
     },
     "SkillEntryObject": {
       "type": "object",
       "properties": {
-        "source": { "type": "string" },
-        "enabled": { "anyOf": [{ "type": "boolean" }, { "type": "null" }] },
-        "authored": { "anyOf": [{ "type": "boolean" }, { "type": "null" }] }
+        "source": { "type": "string", "allOf": [{ "minLength": 1 }] },
+        "enabled": {
+          "anyOf": [
+            {
+              "type": "boolean",
+              "description": "Whether this entry is enabled. Defaults to true when omitted.",
+              "default": true
+            },
+            { "type": "null" }
+          ]
+        },
+        "authored": {
+          "anyOf": [
+            {
+              "type": "boolean",
+              "description": "Whether this entry was authored locally. Defaults to false when omitted.",
+              "default": false
+            },
+            { "type": "null" }
+          ]
+        }
       },
       "required": ["source"],
       "additionalProperties": false,
@@ -184,6 +266,9 @@
     "SkillEntry": { "anyOf": [{ "type": "string" }, { "$ref": "#/definitions/SkillEntryObject" }] },
     "SkillsMap": {
       "type": "object",
+      "title": "Skills Map",
+      "description": "Your installed skills, keyed by name.",
+      "propertyNames": { "pattern": "^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$" },
       "additionalProperties": { "$ref": "#/definitions/SkillEntry" }
     },
     "IgnoredSettings": {
@@ -299,7 +384,7 @@
         "commands": { "anyOf": [{ "$ref": "#/definitions/CommandsMap" }, { "type": "null" }] },
         "subagents": { "anyOf": [{ "$ref": "#/definitions/SubagentsMap" }, { "type": "null" }] },
         "mcpServers": { "anyOf": [{ "$ref": "#/definitions/McpServersMap" }, { "type": "null" }] },
-        "packs": { "anyOf": [{ "$ref": "#/definitions/ExtensionPacksMap" }, { "type": "null" }] },
+        "packs": { "anyOf": [{ "$ref": "#/definitions/PacksMap" }, { "type": "null" }] },
         "skills": { "anyOf": [{ "$ref": "#/definitions/SkillsMap" }, { "type": "null" }] },
         "ignored": { "anyOf": [{ "$ref": "#/definitions/IgnoredSettings" }, { "type": "null" }] },
         "lint": { "anyOf": [{ "$ref": "#/definitions/LintConfig" }, { "type": "null" }] }

package/site-content/__generated__/schemas/skill.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 skill within its owner namespace. Combined with owner, forms the FQN @owner/skills/<name>.",
+          "examples": ["my-skill", "code-review", "prettier"]
+        }
+      ]
     },
-    "PackageUrlParts": { "type": "string" },
-    "ExtensionName": { "type": "string" },
     "SkillManifest": {
       "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": "Skill Manifest",
-      "description": "Configuration file (skill.json) that defines a skill — reusable prompts and context for coding agents."
+      "description": "Extension manifest file for skill. Carries the registry-facing identity, version, and metadata."
     }
   }
 }