@cloudhal/core-contracts 0.3.4 → 0.3.5

package/schemas/.bundled/skill-manifest.schema.json

@@ -1,51 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://cloudhal.dev/schemas/v1/skill-manifest.schema.json",
-  "title": "SkillManifest",
-  "description": "YAML frontmatter of a SKILL.md, exactly the six fields of the Agent Skills specification (agentskills.io). Cloudhal-specific data goes under `metadata` as flat string keys prefixed `cloudhal.` (schemaVersion, requiresCapabilities, scopes, approval); nested vendor blocks are rejected by hosted skill uploaders.",
-  "type": "object",
-  "additionalProperties": false,
-  "required": [
-    "name",
-    "description"
-  ],
-  "properties": {
-    "name": {
-      "type": "string",
-      "description": "Lower-case kebab-case; must equal the skill directory name.",
-      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
-      "minLength": 1,
-      "maxLength": 64
-    },
-    "description": {
-      "type": "string",
-      "minLength": 1,
-      "maxLength": 1024
-    },
-    "license": {
-      "type": "string",
-      "maxLength": 200
-    },
-    "compatibility": {
-      "type": "string",
-      "maxLength": 500
-    },
-    "metadata": {
-      "$ref": "#/$defs/Metadata"
-    },
-    "allowed-tools": {
-      "type": "string",
-      "description": "Space-separated tool names the skill may call (experimental in the spec).",
-      "maxLength": 2000
-    }
-  },
-  "$defs": {
-    "Metadata": {
-      "type": "object",
-      "description": "Free-form string-to-string map for extensions. Keys should be namespaced (e.g. cloudhal.source).",
-      "additionalProperties": {
-        "type": "string"
-      }
-    }
-  }
-}

package/schemas/.bundled/snapshot.schema.json

@@ -1,192 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://cloudhal.dev/schemas/v1/snapshot.schema.json",
-  "title": "Snapshot",
-  "description": "Immutable record of a site's node set at one instant: which nodes existed, at which revision, with which content hash. Every mutation by an agent produces one; publish and rollback point the site at one. Node bodies are stored by hash in the blob store, not here.",
-  "type": "object",
-  "additionalProperties": false,
-  "required": [
-    "schemaVersion",
-    "id",
-    "siteId",
-    "siteRev",
-    "reason",
-    "actor",
-    "nodes",
-    "summary",
-    "createdAt"
-  ],
-  "properties": {
-    "schemaVersion": {
-      "$ref": "#/$defs/SchemaVersion"
-    },
-    "id": {
-      "$ref": "#/$defs/Id"
-    },
-    "siteId": {
-      "$ref": "#/$defs/Id"
-    },
-    "parentId": {
-      "$ref": "#/$defs/Id",
-      "description": "Previous snapshot in this site's history; absent for the first one."
-    },
-    "siteRev": {
-      "$ref": "#/$defs/Revision"
-    },
-    "reason": {
-      "type": "string",
-      "enum": [
-        "manual",
-        "agentMutation",
-        "publish",
-        "rollback",
-        "scheduled",
-        "import"
-      ]
-    },
-    "label": {
-      "type": "string",
-      "maxLength": 200
-    },
-    "actor": {
-      "$ref": "#/$defs/Actor"
-    },
-    "nodes": {
-      "type": "array",
-      "items": {
-        "$ref": "#/$defs/NodeRef"
-      }
-    },
-    "summary": {
-      "$ref": "#/$defs/ChangeSummary"
-    },
-    "createdAt": {
-      "$ref": "#/$defs/Timestamp"
-    },
-    "metadata": {
-      "$ref": "#/$defs/Metadata"
-    }
-  },
-  "$defs": {
-    "Actor": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": [
-        "kind",
-        "id"
-      ],
-      "properties": {
-        "kind": {
-          "$ref": "#/$defs/ActorKind"
-        },
-        "id": {
-          "$ref": "#/$defs/Id"
-        },
-        "name": {
-          "type": "string",
-          "maxLength": 200
-        }
-      }
-    },
-    "ActorKind": {
-      "type": "string",
-      "description": "Who performed an action. Humans and agents share one actor model so the policy engine treats them uniformly.",
-      "enum": [
-        "human",
-        "agent",
-        "system"
-      ]
-    },
-    "ChangeSummary": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": [
-        "added",
-        "changed",
-        "removed"
-      ],
-      "properties": {
-        "added": {
-          "type": "integer",
-          "minimum": 0
-        },
-        "changed": {
-          "type": "integer",
-          "minimum": 0
-        },
-        "removed": {
-          "type": "integer",
-          "minimum": 0
-        }
-      }
-    },
-    "Id": {
-      "type": "string",
-      "description": "Prefixed, URL-safe identifier, e.g. site_01HZX8K3Q9. The prefix names the entity kind; agents and the MCP server pass these as opaque handles.",
-      "pattern": "^[a-z]+_[A-Za-z0-9]{6,32}$",
-      "minLength": 8,
-      "maxLength": 48
-    },
-    "Metadata": {
-      "type": "object",
-      "description": "Free-form string-to-string map for extensions. Keys should be namespaced (e.g. cloudhal.source).",
-      "additionalProperties": {
-        "type": "string"
-      }
-    },
-    "NodeRef": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": [
-        "id",
-        "kind",
-        "rev",
-        "hash"
-      ],
-      "properties": {
-        "id": {
-          "$ref": "#/$defs/Id"
-        },
-        "kind": {
-          "type": "string",
-          "enum": [
-            "site",
-            "page",
-            "contentEntry",
-            "taxonomy",
-            "term",
-            "redirect",
-            "menu",
-            "asset",
-            "glossary"
-          ]
-        },
-        "rev": {
-          "$ref": "#/$defs/Revision"
-        },
-        "hash": {
-          "type": "string",
-          "description": "Lower-case hex SHA-256 of the node's canonical JSON.",
-          "pattern": "^[0-9a-f]{64}$"
-        }
-      }
-    },
-    "Revision": {
-      "type": "integer",
-      "description": "Monotonic per-node revision used for optimistic locking (compare-and-swap on write).",
-      "minimum": 0
-    },
-    "SchemaVersion": {
-      "type": "integer",
-      "description": "Version of this contract. Readers reject unknown versions; migrations move documents forward one version at a time.",
-      "enum": [
-        1
-      ]
-    },
-    "Timestamp": {
-      "type": "string",
-      "description": "RFC 3339 / ISO 8601 instant in UTC.",
-      "format": "date-time"
-    }
-  }
-}

package/schemas/.bundled/taxonomy.schema.json

@@ -1,200 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://cloudhal.dev/schemas/v1/taxonomy.schema.json",
-  "title": "Taxonomy",
-  "description": "A classification scheme of a site (e.g. 'category', 'tag', 'series') and its rules: hierarchy, who may create terms, how many terms an entry takes, and how its archives are published. Terms are separate nodes (term.schema.json) that point here by id (RFC-0002).",
-  "type": "object",
-  "additionalProperties": false,
-  "required": [
-    "schemaVersion",
-    "id",
-    "siteId",
-    "key",
-    "labels",
-    "hierarchical",
-    "allowNewTerms",
-    "required",
-    "archive",
-    "feed",
-    "minEntriesToIndex",
-    "rev",
-    "createdAt",
-    "updatedAt"
-  ],
-  "properties": {
-    "schemaVersion": {
-      "$ref": "#/$defs/SchemaVersion"
-    },
-    "id": {
-      "$ref": "#/$defs/Id"
-    },
-    "siteId": {
-      "$ref": "#/$defs/Id"
-    },
-    "key": {
-      "$ref": "#/$defs/Slug",
-      "description": "Stable name of the taxonomy, unique per site and immutable once created. ContentEntry.terms and filter expressions use it (e.g. 'category:news')."
-    },
-    "labels": {
-      "type": "object",
-      "description": "Display names per locale. Must contain the site's default locale.",
-      "propertyNames": {
-        "$ref": "#/$defs/Locale"
-      },
-      "minProperties": 1,
-      "additionalProperties": {
-        "$ref": "#/$defs/TaxonomyLabel"
-      }
-    },
-    "hierarchical": {
-      "type": "boolean",
-      "description": "Terms may have a parent term (categories). Flat when false (tags)."
-    },
-    "allowNewTerms": {
-      "type": "string",
-      "description": "Who may add terms. none: people only. propose: agents may create terms with status 'proposed' that wait for a person. free: agents may create active terms.",
-      "enum": [
-        "none",
-        "propose",
-        "free"
-      ]
-    },
-    "required": {
-      "type": "boolean",
-      "description": "An entry in review or published status must have at least one term of this taxonomy and an explicit primary term."
-    },
-    "maxPerEntry": {
-      "type": "integer",
-      "description": "Most terms of this taxonomy one entry may carry. Absent: the contract limit of 50.",
-      "minimum": 1,
-      "maximum": 50
-    },
-    "collections": {
-      "type": "array",
-      "description": "Collections this taxonomy applies to. Absent: every collection.",
-      "items": {
-        "$ref": "#/$defs/Slug"
-      },
-      "minItems": 1,
-      "maxItems": 50,
-      "uniqueItems": true
-    },
-    "archive": {
-      "$ref": "#/$defs/TaxonomyArchive"
-    },
-    "feed": {
-      "type": "boolean",
-      "description": "Publish an RSS feed per term at <archive.basePath>/<slug>/rss.xml. Requires archive.enabled."
-    },
-    "minEntriesToIndex": {
-      "type": "integer",
-      "description": "Archives listing fewer published entries than this are served with robots 'noindex, follow' and left out of the sitemap.",
-      "minimum": 0,
-      "maximum": 1000
-    },
-    "rev": {
-      "$ref": "#/$defs/Revision"
-    },
-    "createdAt": {
-      "$ref": "#/$defs/Timestamp"
-    },
-    "updatedAt": {
-      "$ref": "#/$defs/Timestamp"
-    },
-    "metadata": {
-      "$ref": "#/$defs/Metadata"
-    }
-  },
-  "$defs": {
-    "Id": {
-      "type": "string",
-      "description": "Prefixed, URL-safe identifier, e.g. site_01HZX8K3Q9. The prefix names the entity kind; agents and the MCP server pass these as opaque handles.",
-      "pattern": "^[a-z]+_[A-Za-z0-9]{6,32}$",
-      "minLength": 8,
-      "maxLength": 48
-    },
-    "Locale": {
-      "type": "string",
-      "description": "BCP 47 language tag, e.g. en, tr, en-US.",
-      "pattern": "^[a-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$"
-    },
-    "Metadata": {
-      "type": "object",
-      "description": "Free-form string-to-string map for extensions. Keys should be namespaced (e.g. cloudhal.source).",
-      "additionalProperties": {
-        "type": "string"
-      }
-    },
-    "Path": {
-      "type": "string",
-      "description": "Absolute URL path of a route the site owns: starts with '/', lower-case slug segments, no trailing slash except root.",
-      "pattern": "^/(?:[a-z0-9]+(?:-[a-z0-9]+)*(?:/[a-z0-9]+(?:-[a-z0-9]+)*)*)?$",
-      "maxLength": 1024
-    },
-    "Revision": {
-      "type": "integer",
-      "description": "Monotonic per-node revision used for optimistic locking (compare-and-swap on write).",
-      "minimum": 0
-    },
-    "SchemaVersion": {
-      "type": "integer",
-      "description": "Version of this contract. Readers reject unknown versions; migrations move documents forward one version at a time.",
-      "enum": [
-        1
-      ]
-    },
-    "Slug": {
-      "type": "string",
-      "description": "Lower-case URL segment.",
-      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
-      "minLength": 1,
-      "maxLength": 128
-    },
-    "TaxonomyArchive": {
-      "type": "object",
-      "description": "Public archive pages: <basePath>/<term-slug> and <basePath>/<term-slug>/page/<n>.",
-      "additionalProperties": false,
-      "required": [
-        "enabled",
-        "basePath"
-      ],
-      "properties": {
-        "enabled": {
-          "type": "boolean"
-        },
-        "basePath": {
-          "$ref": "#/$defs/Path"
-        }
-      }
-    },
-    "TaxonomyLabel": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": [
-        "singular",
-        "plural"
-      ],
-      "properties": {
-        "singular": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 100
-        },
-        "plural": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 100
-        },
-        "description": {
-          "type": "string",
-          "maxLength": 1000
-        }
-      }
-    },
-    "Timestamp": {
-      "type": "string",
-      "description": "RFC 3339 / ISO 8601 instant in UTC.",
-      "format": "date-time"
-    }
-  }
-}