@agentxm/client-core 0.11.2 → 0.11.3

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

@@ -0,0 +1,500 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/ContextFilesManifest",
+  "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 context files package within its owner namespace. Combined with owner, forms the FQN @owner/files/<name>.",
+          "examples": ["my-skill", "code-review", "prettier"]
+        }
+      ]
+    },
+    "ContextFilesInputStringDeclaration": {
+      "type": "object",
+      "properties": {
+        "type": { "type": "string", "enum": ["string"] },
+        "prompt": { "anyOf": [{ "type": "string" }, { "type": "null" }] },
+        "default": { "anyOf": [{ "type": "string" }, { "type": "null" }] }
+      },
+      "required": ["type"],
+      "additionalProperties": false,
+      "title": "Context Files Input String Declaration"
+    },
+    "ContextFilesInputNumberDeclaration": {
+      "type": "object",
+      "properties": {
+        "type": { "type": "string", "enum": ["number"] },
+        "prompt": { "anyOf": [{ "type": "string" }, { "type": "null" }] },
+        "default": {
+          "anyOf": [
+            {
+              "anyOf": [
+                { "type": "number" },
+                { "type": "string", "enum": ["NaN"] },
+                { "type": "string", "enum": ["Infinity"] },
+                { "type": "string", "enum": ["-Infinity"] }
+              ]
+            },
+            { "type": "null" }
+          ]
+        }
+      },
+      "required": ["type"],
+      "additionalProperties": false,
+      "title": "Context Files Input Number Declaration"
+    },
+    "ContextFilesInputBooleanDeclaration": {
+      "type": "object",
+      "properties": {
+        "type": { "type": "string", "enum": ["boolean"] },
+        "prompt": { "anyOf": [{ "type": "string" }, { "type": "null" }] },
+        "default": { "anyOf": [{ "type": "boolean" }, { "type": "null" }] }
+      },
+      "required": ["type"],
+      "additionalProperties": false,
+      "title": "Context Files Input Boolean Declaration"
+    },
+    "ContextFilesInputEnumDeclaration": {
+      "type": "object",
+      "properties": {
+        "type": { "type": "string", "enum": ["enum"] },
+        "prompt": { "anyOf": [{ "type": "string" }, { "type": "null" }] },
+        "values": {
+          "type": "array",
+          "allOf": [{ "minItems": 1 }],
+          "items": { "type": "string", "allOf": [{ "minLength": 1 }] }
+        },
+        "default": { "anyOf": [{ "type": "string" }, { "type": "null" }] }
+      },
+      "required": ["type", "values"],
+      "additionalProperties": false,
+      "title": "Context Files Input Enum Declaration"
+    },
+    "ContextFilesInputDeclaration": {
+      "anyOf": [
+        { "$ref": "#/definitions/ContextFilesInputStringDeclaration" },
+        { "$ref": "#/definitions/ContextFilesInputNumberDeclaration" },
+        { "$ref": "#/definitions/ContextFilesInputBooleanDeclaration" },
+        { "$ref": "#/definitions/ContextFilesInputEnumDeclaration" }
+      ],
+      "title": "Context Files Input Declaration",
+      "description": "A scalar input declaration for a context files template."
+    },
+    "ContextFilesInputDeclarationsMap": {
+      "type": "object",
+      "additionalProperties": { "$ref": "#/definitions/ContextFilesInputDeclaration" },
+      "title": "Context Files Input Declarations Map"
+    },
+    "ContextFilesSourcePath": {
+      "anyOf": [
+        { "type": "string", "allOf": [{ "minLength": 1 }] },
+        {
+          "type": "array",
+          "allOf": [{ "minItems": 1 }],
+          "items": { "type": "string", "allOf": [{ "minLength": 1 }] }
+        }
+      ],
+      "title": "Context 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/ContextFilesSourcePath" }
+      },
+      "required": ["kind", "path"],
+      "additionalProperties": false,
+      "title": "Static Content Source"
+    },
+    "TemplateContentSource": {
+      "type": "object",
+      "properties": {
+        "kind": { "type": "string", "enum": ["template"] },
+        "path": { "$ref": "#/definitions/ContextFilesSourcePath" }
+      },
+      "required": ["kind", "path"],
+      "additionalProperties": false,
+      "title": "Template Content Source"
+    },
+    "ContextFilesInputValue": {
+      "anyOf": [
+        { "type": "string" },
+        {
+          "anyOf": [
+            { "type": "number" },
+            { "type": "string", "enum": ["NaN"] },
+            { "type": "string", "enum": ["Infinity"] },
+            { "type": "string", "enum": ["-Infinity"] }
+          ]
+        },
+        { "type": "boolean" }
+      ],
+      "title": "Context Files Input Value",
+      "description": "Scalar value used to render context files templates."
+    },
+    "ContextFilesGeneratorSpec": {
+      "type": "object",
+      "properties": {
+        "name": { "type": "string", "enum": ["toc", "file-index"] },
+        "options": {
+          "anyOf": [
+            {
+              "type": "object",
+              "additionalProperties": { "$ref": "#/definitions/ContextFilesInputValue" }
+            },
+            { "type": "null" }
+          ]
+        }
+      },
+      "required": ["name"],
+      "additionalProperties": false,
+      "title": "Context 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/ContextFilesGeneratorSpec" }
+      },
+      "required": ["kind", "generator"],
+      "additionalProperties": false,
+      "title": "Generated Content Source"
+    },
+    "ContextFilesContentSource": {
+      "anyOf": [
+        { "$ref": "#/definitions/StaticContentSource" },
+        { "$ref": "#/definitions/TemplateContentSource" },
+        { "$ref": "#/definitions/GeneratedContentSource" }
+      ],
+      "title": "Context Files Content Source",
+      "description": "Static, template, or generated source for a materialized file target."
+    },
+    "WholeFileContentsEntry": {
+      "type": "object",
+      "properties": {
+        "source": { "$ref": "#/definitions/ContextFilesContentSource" },
+        "target": { "type": "string", "allOf": [{ "minLength": 1 }] },
+        "mode": { "type": "string", "enum": ["sync-once", "sync-always"] }
+      },
+      "required": ["source", "target", "mode"],
+      "additionalProperties": false,
+      "title": "Whole File Contents Entry"
+    },
+    "ManagedRegionContentsEntry": {
+      "type": "object",
+      "properties": {
+        "source": { "$ref": "#/definitions/ContextFilesContentSource" },
+        "target": { "type": "string", "allOf": [{ "minLength": 1 }] },
+        "mode": { "type": "string", "enum": ["managed-region"] },
+        "region": { "type": "string", "allOf": [{ "minLength": 1 }] },
+        "anchor": {
+          "anyOf": [{ "type": "string", "allOf": [{ "minLength": 1 }] }, { "type": "null" }]
+        }
+      },
+      "required": ["source", "target", "mode", "region"],
+      "additionalProperties": false,
+      "title": "Managed Region Contents Entry"
+    },
+    "ContextFilesContentsEntry": {
+      "anyOf": [
+        { "$ref": "#/definitions/WholeFileContentsEntry" },
+        { "$ref": "#/definitions/ManagedRegionContentsEntry" }
+      ],
+      "title": "Context Files Contents Entry",
+      "description": "A context files package content source and the workspace target it materializes into."
+    },
+    "ContextFilesManifest": {
+      "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": ["file"] },
+        "name": { "$ref": "#/definitions/ExtensionName" },
+        "inputs": {
+          "anyOf": [
+            { "$ref": "#/definitions/ContextFilesInputDeclarationsMap" },
+            { "type": "null" }
+          ]
+        },
+        "contents": {
+          "type": "array",
+          "allOf": [{ "minItems": 1 }],
+          "items": { "$ref": "#/definitions/ContextFilesContentsEntry" }
+        }
+      },
+      "required": ["owner", "version", "type", "name", "contents"],
+      "additionalProperties": false,
+      "title": "Context Files Manifest",
+      "description": "Context files manifest for structural workspace file distribution. Declares payload sources, inputs, and materialization targets."
+    }
+  }
+}