@agentxm/client-core 0.13.1 → 0.13.2

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

@@ -7,7 +7,7 @@
       "type": "string",
       "allOf": [
         {
-          "pattern": "^(@[a-z0-9_](?:[a-z0-9_-]*[a-z0-9_])?)\\/(skills|commands|mcps|subagents|docs|rules|packs)\\/([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|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"]

package/site-content/__generated__/schemas/{docs.schema.json → files.schema.json}

@@ -1,7 +1,7 @@
 {
   "$comment": "@generated by core:generate:schemas (packages/cli/scripts/generate-schemas.ts). Regenerate: pnpm exec nx run core:generate:schemas. DO NOT EDIT.",
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$ref": "#/definitions/DocsManifest",
+  "$ref": "#/definitions/FilesManifest",
   "definitions": {
     "Handle": {
       "type": "string",
@@ -196,12 +196,12 @@
         {
           "pattern": "^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$",
           "title": "Extension Name",
-          "description": "Short name for this docs package within its owner namespace. Combined with owner, forms the FQN @owner/docs/<name>.",
+          "description": "Short name for this files package within its owner namespace. Combined with owner, forms the FQN @owner/files/<name>.",
           "examples": ["my-skill", "code-review", "prettier"]
         }
       ]
     },
-    "DocsInputStringDeclaration": {
+    "FilesInputStringDeclaration": {
       "type": "object",
       "properties": {
         "type": { "type": "string", "enum": ["string"] },
@@ -210,9 +210,9 @@
       },
       "required": ["type"],
       "additionalProperties": false,
-      "title": "Docs Input String Declaration"
+      "title": "Files Input String Declaration"
     },
-    "DocsInputNumberDeclaration": {
+    "FilesInputNumberDeclaration": {
       "type": "object",
       "properties": {
         "type": { "type": "string", "enum": ["number"] },
@@ -233,9 +233,9 @@
       },
       "required": ["type"],
       "additionalProperties": false,
-      "title": "Docs Input Number Declaration"
+      "title": "Files Input Number Declaration"
     },
-    "DocsInputBooleanDeclaration": {
+    "FilesInputBooleanDeclaration": {
       "type": "object",
       "properties": {
         "type": { "type": "string", "enum": ["boolean"] },
@@ -244,9 +244,9 @@
       },
       "required": ["type"],
       "additionalProperties": false,
-      "title": "Docs Input Boolean Declaration"
+      "title": "Files Input Boolean Declaration"
     },
-    "DocsInputEnumDeclaration": {
+    "FilesInputEnumDeclaration": {
       "type": "object",
       "properties": {
         "type": { "type": "string", "enum": ["enum"] },
@@ -260,24 +260,24 @@
       },
       "required": ["type", "values"],
       "additionalProperties": false,
-      "title": "Docs Input Enum Declaration"
+      "title": "Files Input Enum Declaration"
     },
-    "DocsInputDeclaration": {
+    "FilesInputDeclaration": {
       "anyOf": [
-        { "$ref": "#/definitions/DocsInputStringDeclaration" },
-        { "$ref": "#/definitions/DocsInputNumberDeclaration" },
-        { "$ref": "#/definitions/DocsInputBooleanDeclaration" },
-        { "$ref": "#/definitions/DocsInputEnumDeclaration" }
+        { "$ref": "#/definitions/FilesInputStringDeclaration" },
+        { "$ref": "#/definitions/FilesInputNumberDeclaration" },
+        { "$ref": "#/definitions/FilesInputBooleanDeclaration" },
+        { "$ref": "#/definitions/FilesInputEnumDeclaration" }
       ],
-      "title": "Docs Input Declaration",
-      "description": "A scalar input declaration for a docs template."
+      "title": "Files Input Declaration",
+      "description": "A scalar input declaration for a files template."
     },
-    "DocsInputDeclarationsMap": {
+    "FilesInputDeclarationsMap": {
       "type": "object",
-      "additionalProperties": { "$ref": "#/definitions/DocsInputDeclaration" },
-      "title": "Docs Input Declarations Map"
+      "additionalProperties": { "$ref": "#/definitions/FilesInputDeclaration" },
+      "title": "Files Input Declarations Map"
     },
-    "DocsSourcePath": {
+    "FilesSourcePath": {
       "anyOf": [
         { "type": "string", "allOf": [{ "minLength": 1 }] },
         {
@@ -286,14 +286,14 @@
           "items": { "type": "string", "allOf": [{ "minLength": 1 }] }
         }
       ],
-      "title": "Docs Source Path",
+      "title": "Files Source Path",
       "description": "A payload path within src/, or an ordered list of payload paths to concatenate."
     },
     "StaticContentSource": {
       "type": "object",
       "properties": {
         "kind": { "type": "string", "enum": ["static"] },
-        "path": { "$ref": "#/definitions/DocsSourcePath" }
+        "path": { "$ref": "#/definitions/FilesSourcePath" }
       },
       "required": ["kind", "path"],
       "additionalProperties": false,
@@ -303,13 +303,13 @@
       "type": "object",
       "properties": {
         "kind": { "type": "string", "enum": ["template"] },
-        "path": { "$ref": "#/definitions/DocsSourcePath" }
+        "path": { "$ref": "#/definitions/FilesSourcePath" }
       },
       "required": ["kind", "path"],
       "additionalProperties": false,
       "title": "Template Content Source"
     },
-    "DocsInputValue": {
+    "FilesInputValue": {
       "anyOf": [
         { "type": "string" },
         {
@@ -322,10 +322,10 @@
         },
         { "type": "boolean" }
       ],
-      "title": "Docs Input Value",
-      "description": "Scalar value used to render docs templates."
+      "title": "Files Input Value",
+      "description": "Scalar value used to render files templates."
     },
-    "DocsGeneratorSpec": {
+    "FilesGeneratorSpec": {
       "type": "object",
       "properties": {
         "name": { "type": "string", "enum": ["toc", "file-index"] },
@@ -333,7 +333,7 @@
           "anyOf": [
             {
               "type": "object",
-              "additionalProperties": { "$ref": "#/definitions/DocsInputValue" }
+              "additionalProperties": { "$ref": "#/definitions/FilesInputValue" }
             },
             { "type": "null" }
           ]
@@ -341,32 +341,32 @@
       },
       "required": ["name"],
       "additionalProperties": false,
-      "title": "Docs Generator Spec",
+      "title": "Files Generator Spec",
       "description": "A supported v1 generated content source and scalar options."
     },
     "GeneratedContentSource": {
       "type": "object",
       "properties": {
         "kind": { "type": "string", "enum": ["generated"] },
-        "generator": { "$ref": "#/definitions/DocsGeneratorSpec" }
+        "generator": { "$ref": "#/definitions/FilesGeneratorSpec" }
       },
       "required": ["kind", "generator"],
       "additionalProperties": false,
       "title": "Generated Content Source"
     },
-    "DocsContentSource": {
+    "FilesContentSource": {
       "anyOf": [
         { "$ref": "#/definitions/StaticContentSource" },
         { "$ref": "#/definitions/TemplateContentSource" },
         { "$ref": "#/definitions/GeneratedContentSource" }
       ],
-      "title": "Docs Content Source",
+      "title": "Files Content Source",
       "description": "Static, template, or generated source for a materialized file target."
     },
     "WholeFileContentsEntry": {
       "type": "object",
       "properties": {
-        "source": { "$ref": "#/definitions/DocsContentSource" },
+        "source": { "$ref": "#/definitions/FilesContentSource" },
         "target": { "type": "string", "allOf": [{ "minLength": 1 }] },
         "mode": { "type": "string", "enum": ["sync-once", "sync-always"] }
       },
@@ -377,7 +377,7 @@
     "ManagedRegionContentsEntry": {
       "type": "object",
       "properties": {
-        "source": { "$ref": "#/definitions/DocsContentSource" },
+        "source": { "$ref": "#/definitions/FilesContentSource" },
         "target": { "type": "string", "allOf": [{ "minLength": 1 }] },
         "mode": { "type": "string", "enum": ["managed-region"] },
         "region": { "type": "string", "allOf": [{ "minLength": 1 }] },
@@ -389,15 +389,15 @@
       "additionalProperties": false,
       "title": "Managed Region Contents Entry"
     },
-    "DocsContentsEntry": {
+    "FilesContentsEntry": {
       "anyOf": [
         { "$ref": "#/definitions/WholeFileContentsEntry" },
         { "$ref": "#/definitions/ManagedRegionContentsEntry" }
       ],
-      "title": "Docs Contents Entry",
-      "description": "A docs package content source and the workspace target it materializes into."
+      "title": "Files Contents Entry",
+      "description": "A files package content source and the workspace target it materializes into."
     },
-    "DocsManifest": {
+    "FilesManifest": {
       "type": "object",
       "properties": {
         "$schema": { "anyOf": [{ "type": "string" }, { "type": "null" }] },
@@ -478,21 +478,21 @@
             { "type": "null" }
           ]
         },
-        "type": { "type": "string", "enum": ["docs"] },
+        "type": { "type": "string", "enum": ["files"] },
         "name": { "$ref": "#/definitions/ExtensionName" },
         "inputs": {
-          "anyOf": [{ "$ref": "#/definitions/DocsInputDeclarationsMap" }, { "type": "null" }]
+          "anyOf": [{ "$ref": "#/definitions/FilesInputDeclarationsMap" }, { "type": "null" }]
         },
         "contents": {
           "type": "array",
           "allOf": [{ "minItems": 1 }],
-          "items": { "$ref": "#/definitions/DocsContentsEntry" }
+          "items": { "$ref": "#/definitions/FilesContentsEntry" }
         }
       },
       "required": ["owner", "version", "type", "name", "contents"],
       "additionalProperties": false,
-      "title": "Docs Manifest",
-      "description": "docs manifest for structural workspace file distribution. Declares payload sources, inputs, and materialization targets."
+      "title": "Files Manifest",
+      "description": "files manifest for structural workspace file distribution. Declares payload sources, inputs, and materialization targets."
     }
   }
 }

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

@@ -0,0 +1,375 @@
+{
+  "$comment": "@generated by core:generate:schemas (packages/cli/scripts/generate-schemas.ts). Regenerate: pnpm exec nx run core:generate:schemas. DO NOT EDIT.",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/HookManifest",
+  "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 name for this hook within its owner namespace. Combined with owner, forms the FQN @owner/hooks/<name>.",
+          "examples": ["my-skill", "code-review", "prettier"]
+        }
+      ]
+    },
+    "HookRuntime": {
+      "type": "string",
+      "enum": ["bash", "node", "python"],
+      "title": "Hook Runtime",
+      "description": "Interpreter family used to execute the materialized hook entrypoint."
+    },
+    "HookEvent": {
+      "type": "string",
+      "enum": [
+        "PreToolUse",
+        "PostToolUse",
+        "UserPromptSubmit",
+        "SessionStart",
+        "Stop",
+        "SubagentStop",
+        "PreCompact"
+      ],
+      "title": "Hook Event",
+      "description": "Agent hook event this extension binds to."
+    },
+    "HookBinding": {
+      "type": "object",
+      "properties": {
+        "event": { "$ref": "#/definitions/HookEvent" },
+        "matcher": {
+          "anyOf": [{ "type": "string", "allOf": [{ "minLength": 1 }] }, { "type": "null" }]
+        }
+      },
+      "required": ["event"],
+      "additionalProperties": false
+    },
+    "HookCapabilities": {
+      "type": "object",
+      "properties": {
+        "network": { "anyOf": [{ "type": "boolean" }, { "type": "null" }] },
+        "filesystemWrite": { "anyOf": [{ "type": "boolean" }, { "type": "null" }] },
+        "exec": {
+          "anyOf": [
+            { "type": "array", "items": { "type": "string", "allOf": [{ "minLength": 1 }] } },
+            { "type": "null" }
+          ]
+        },
+        "env": {
+          "anyOf": [
+            { "type": "array", "items": { "type": "string", "allOf": [{ "minLength": 1 }] } },
+            { "type": "null" }
+          ]
+        }
+      },
+      "additionalProperties": false,
+      "title": "Hook Capabilities",
+      "description": "Advisory author-declared hook capability surface. v1 does not enforce it."
+    },
+    "HookManifest": {
+      "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" }
+          ]
+        },
+        "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": ["hook"] },
+        "name": { "$ref": "#/definitions/ExtensionName" },
+        "title": {
+          "anyOf": [
+            {
+              "type": "string",
+              "allOf": [{ "minLength": 1, "description": "Optional display title for this hook." }]
+            },
+            { "type": "null" }
+          ]
+        },
+        "runtime": { "$ref": "#/definitions/HookRuntime" },
+        "entrypoint": {
+          "type": "string",
+          "allOf": [
+            {
+              "minLength": 1,
+              "description": "Hook body entrypoint path, relative to the hook manifest directory.",
+              "examples": ["src/hook.sh", "src/hook.js", "src/hook.py"]
+            }
+          ]
+        },
+        "bindings": { "type": "array", "items": { "$ref": "#/definitions/HookBinding" } },
+        "timeoutMs": {
+          "anyOf": [{ "type": "integer", "allOf": [{ "exclusiveMinimum": 0 }] }, { "type": "null" }]
+        },
+        "blocking": { "anyOf": [{ "type": "boolean" }, { "type": "null" }] },
+        "capabilities": {
+          "anyOf": [{ "$ref": "#/definitions/HookCapabilities" }, { "type": "null" }]
+        }
+      },
+      "required": ["owner", "version", "type", "name", "runtime", "entrypoint", "bindings"],
+      "additionalProperties": false,
+      "title": "Hook Manifest",
+      "description": "Hook manifest for managed agent hooks. The executable body lives under src/ and is invoked from native agent settings."
+    }
+  }
+}

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

@@ -193,9 +193,9 @@
       "type": "string",
       "allOf": [
         {
-          "pattern": "^(@[a-z0-9_](?:[a-z0-9_-]*[a-z0-9_])?)\\/(skills|commands|mcps|subagents|docs|rules)\\/([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)\\/([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).",
+          "description": "Extension identifier restricted to non-pack types (skills, commands, mcps, subagents, context, rules, hooks).",
           "examples": ["@acme/skills/code-review", "@my-org/commands/format"]
         }
       ]
@@ -285,7 +285,7 @@
       "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, Context docs packages, and rules into a single installable unit."
+      "description": "Extension manifest file for extension packs. Bundles a curated set of skills, commands, MCP servers, subagents, Context Files packages, and rules into a single installable unit."
     }
   }
 }