@open-agent-toolkit/cli 0.2.4 → 0.2.6

package/assets/skills/explainer-kit/schemas/manifest.schema.json

@@ -0,0 +1,193 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "explainer-kit.manifest/v1",
+  "title": "ArtifactManifestV1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "runId",
+    "slug",
+    "recipe",
+    "createdAt",
+    "source",
+    "theme",
+    "artifacts",
+    "immutableHashes",
+    "outcome",
+    "buildRecord",
+    "warnings"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "explainer-kit.manifest/v1" },
+    "runId": { "type": "string", "minLength": 1 },
+    "slug": {
+      "type": "string",
+      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
+    },
+    "recipe": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "version"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "version": { "type": "string", "minLength": 1 }
+      }
+    },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["factBasePath", "factBaseHash", "inputHashes"],
+      "properties": {
+        "factBasePath": { "$ref": "#/$defs/safeRelativePath" },
+        "factBaseHash": { "$ref": "#/$defs/hash" },
+        "sourceRevision": { "type": "string", "minLength": 1 },
+        "inputHashes": { "$ref": "#/$defs/hashMap" }
+      }
+    },
+    "theme": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "hash", "derived"],
+      "properties": {
+        "path": { "const": "theme.resolved.json" },
+        "hash": { "$ref": "#/$defs/hash" },
+        "derived": { "type": "boolean" }
+      }
+    },
+    "artifacts": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/artifactEntry" },
+      "uniqueItems": true
+    },
+    "immutableHashes": { "$ref": "#/$defs/hashMap" },
+    "outcome": {
+      "enum": ["built-durable", "built-not-durable", "failed", "incomplete"]
+    },
+    "buildRecord": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "hash"],
+      "properties": {
+        "path": { "const": "build-record.json" },
+        "hash": { "$ref": "#/$defs/hash" }
+      }
+    },
+    "publishReceipt": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "hash"],
+      "properties": {
+        "path": { "const": "publish-receipt.json" },
+        "hash": { "$ref": "#/$defs/hash" }
+      }
+    },
+    "warnings": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    }
+  },
+  "$defs": {
+    "hash": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "safeRelativePath": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$)).+$"
+    },
+    "hashMap": {
+      "type": "object",
+      "propertyNames": { "$ref": "#/$defs/safeRelativePath" },
+      "additionalProperties": { "$ref": "#/$defs/hash" }
+    },
+    "failure": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "message", "recovery"],
+      "properties": {
+        "code": { "type": "string", "minLength": 1 },
+        "message": { "type": "string", "minLength": 1 },
+        "recovery": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "minItems": 1
+        }
+      }
+    },
+    "durableEvidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "ref", "paths", "attestedAt"],
+      "properties": {
+        "kind": { "enum": ["commit", "publish"] },
+        "ref": { "type": "string", "minLength": 1 },
+        "paths": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/safeRelativePath" },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "attestedAt": { "type": "string", "format": "date-time" },
+        "supersedes": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["ref", "paths"],
+          "properties": {
+            "ref": { "type": "string", "minLength": 1 },
+            "paths": {
+              "type": "array",
+              "items": { "$ref": "#/$defs/safeRelativePath" },
+              "minItems": 1,
+              "uniqueItems": true
+            }
+          }
+        }
+      }
+    },
+    "rebuild": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["argv", "cwd", "inputHashes"],
+      "properties": {
+        "argv": {
+          "type": "array",
+          "items": { "type": "string" },
+          "minItems": 1
+        },
+        "cwd": { "type": "string", "minLength": 1 },
+        "inputHashes": { "$ref": "#/$defs/hashMap" }
+      }
+    },
+    "artifactEntry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "type", "contentPath", "status", "rebuildable"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "type": { "enum": ["hub", "diagram", "explainer", "deck", "catalog"] },
+        "contentPath": { "$ref": "#/$defs/safeRelativePath" },
+        "renderedPath": {
+          "allOf": [
+            { "$ref": "#/$defs/safeRelativePath" },
+            { "pattern": "^site/" }
+          ],
+          "pattern": "^site/"
+        },
+        "mediaType": { "type": "string", "minLength": 1 },
+        "status": { "enum": ["built", "failed", "skipped"] },
+        "hash": { "$ref": "#/$defs/hash" },
+        "rebuildable": { "type": "boolean" },
+        "rebuild": { "$ref": "#/$defs/rebuild" },
+        "durableEvidence": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/durableEvidence" },
+          "uniqueItems": true
+        },
+        "failure": { "$ref": "#/$defs/failure" }
+      }
+    }
+  }
+}

package/assets/skills/explainer-kit/schemas/publish-receipt.schema.json

@@ -0,0 +1,97 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "explainer-kit.publish-receipt/v1",
+  "title": "PublishReceiptV1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "provider",
+    "publishedAt",
+    "roots",
+    "sentinel",
+    "artifacts"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "explainer-kit.publish-receipt/v1" },
+    "provider": { "const": "s3-static" },
+    "publishedAt": { "type": "string", "format": "date-time" },
+    "roots": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["s3Uri", "publicBaseUrl"],
+      "properties": {
+        "s3Uri": {
+          "type": "string",
+          "pattern": "^s3://[^/\\s]+(?:/[^\\s]*)?$"
+        },
+        "publicBaseUrl": {
+          "type": "string",
+          "pattern": "^https://[^\\s]+$"
+        }
+      }
+    },
+    "sentinel": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "relativePath",
+        "uploadVerified",
+        "publicVerified",
+        "deleted"
+      ],
+      "properties": {
+        "relativePath": { "$ref": "#/$defs/safeRelativePath" },
+        "uploadVerified": { "type": "boolean" },
+        "publicVerified": { "type": "boolean" },
+        "deleted": { "type": "boolean" }
+      }
+    },
+    "artifacts": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/artifact" },
+      "uniqueItems": true
+    }
+  },
+  "$defs": {
+    "hash": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "safeRelativePath": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$)).+$"
+    },
+    "artifact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "relativePath",
+        "hash",
+        "s3Uri",
+        "publicUrl",
+        "httpStatus",
+        "contentType"
+      ],
+      "properties": {
+        "relativePath": { "$ref": "#/$defs/safeRelativePath" },
+        "hash": { "$ref": "#/$defs/hash" },
+        "s3Uri": {
+          "type": "string",
+          "pattern": "^s3://[^/\\s]+/.+$"
+        },
+        "publicUrl": {
+          "type": "string",
+          "pattern": "^https://[^\\s]+$"
+        },
+        "httpStatus": {
+          "type": "integer",
+          "minimum": 200,
+          "maximum": 299
+        },
+        "contentType": { "type": "string", "minLength": 1 }
+      }
+    }
+  }
+}

package/assets/skills/explainer-kit/schemas/publish-request.schema.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "explainer-kit.publish-request/v1",
+  "title": "S3StaticPublishRequestV1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "provider",
+    "s3Uri",
+    "publicBaseUrl",
+    "awsRegion",
+    "siteRoot",
+    "manifestPath"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "explainer-kit.publish-request/v1" },
+    "provider": { "const": "s3-static" },
+    "s3Uri": {
+      "type": "string",
+      "pattern": "^s3://[^/\\s]+(?:/[^\\s]*)?$"
+    },
+    "publicBaseUrl": {
+      "type": "string",
+      "pattern": "^https://[^\\s]+$"
+    },
+    "awsRegion": { "type": "string", "minLength": 1 },
+    "awsProfile": { "type": "string", "minLength": 1 },
+    "siteRoot": { "type": "string", "minLength": 1 },
+    "manifestPath": { "type": "string", "minLength": 1 }
+  }
+}

package/assets/skills/explainer-kit/schemas/run-request.schema.json

@@ -0,0 +1,132 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "explainer-kit.run-request/v1",
+  "title": "ExplainerRunRequestV1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "recipe",
+    "slug",
+    "outputRoot",
+    "factBase",
+    "mode"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "explainer-kit.run-request/v1"
+    },
+    "recipe": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "version"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "version": { "type": "string", "minLength": 1 }
+      }
+    },
+    "slug": {
+      "type": "string",
+      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
+    },
+    "outputRoot": { "$ref": "#/$defs/relativeOrAbsolutePath" },
+    "factBase": { "$ref": "#/$defs/factBaseBinding" },
+    "theme": { "$ref": "#/$defs/themeSelection" },
+    "publicBaseUrl": { "type": "string", "format": "uri" },
+    "durability": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["strategy"],
+      "properties": {
+        "strategy": {
+          "enum": ["none", "commit", "publish"]
+        },
+        "publish": {
+          "$ref": "explainer-kit.publish-request/v1"
+        }
+      }
+    },
+    "privacy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["retainRawArtDirection"],
+      "properties": {
+        "retainRawArtDirection": { "type": "boolean" }
+      }
+    },
+    "mode": { "enum": ["interactive", "unattended"] }
+  },
+  "$defs": {
+    "relativeOrAbsolutePath": {
+      "type": "string",
+      "minLength": 1
+    },
+    "safeRelativePath": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$)).+$"
+    },
+    "sourceBinding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "kind", "locator", "role", "sourceSetId"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "kind": {
+          "enum": ["file", "directory", "git", "github", "session", "other"]
+        },
+        "locator": { "type": "string", "minLength": 1 },
+        "role": { "type": "string", "minLength": 1 },
+        "sourceSetId": { "type": "string", "minLength": 1 },
+        "revision": { "type": "string", "minLength": 1 },
+        "authoritativeFor": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true
+        }
+      }
+    },
+    "factBaseBinding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["mode", "freshnessPolicy"],
+      "properties": {
+        "mode": { "enum": ["supplied", "federated"] },
+        "path": { "$ref": "#/$defs/relativeOrAbsolutePath" },
+        "sources": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/sourceBinding" },
+          "minItems": 1
+        },
+        "freshnessPolicy": { "const": "live-wins" }
+      },
+      "oneOf": [
+        {
+          "required": ["path"],
+          "properties": { "mode": { "const": "supplied" } }
+        },
+        {
+          "required": ["sources"],
+          "properties": { "mode": { "const": "federated" } }
+        }
+      ]
+    },
+    "themeSelection": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "palette": { "type": "string", "minLength": 1 },
+        "visualProfile": { "type": "string", "minLength": 1 },
+        "suppliedBundlePath": {
+          "$ref": "#/$defs/relativeOrAbsolutePath"
+        },
+        "artDirection": { "type": "string", "minLength": 1 },
+        "defaultMode": { "enum": ["light", "dark"] },
+        "renderStrategy": {
+          "enum": ["default-only", "user-switchable"],
+          "default": "default-only"
+        }
+      }
+    }
+  }
+}

package/assets/skills/explainer-kit/schemas/theme.schema.json

@@ -0,0 +1,217 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "explainer-kit.theme/v1",
+  "title": "ResolvedThemeV1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "name",
+    "defaultMode",
+    "modes",
+    "provenance",
+    "typography",
+    "spacing",
+    "geometry",
+    "elevation",
+    "density",
+    "motion",
+    "diagrams",
+    "bundleHash"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "explainer-kit.theme/v1" },
+    "name": { "type": "string", "minLength": 1 },
+    "defaultMode": { "enum": ["light", "dark"] },
+    "modes": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["light", "dark"],
+      "properties": {
+        "light": { "$ref": "#/$defs/colors" },
+        "dark": { "$ref": "#/$defs/colors" }
+      }
+    },
+    "provenance": { "$ref": "#/$defs/provenance" },
+    "typography": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["sans", "serif", "mono", "scale", "lineHeight"],
+      "properties": {
+        "sans": { "$ref": "#/$defs/fontList" },
+        "serif": { "$ref": "#/$defs/fontList" },
+        "mono": { "$ref": "#/$defs/fontList" },
+        "scale": { "$ref": "#/$defs/stringMap" },
+        "lineHeight": { "$ref": "#/$defs/positiveNumberMap" }
+      }
+    },
+    "spacing": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["unit", "scale"],
+      "properties": {
+        "unit": { "type": "number", "exclusiveMinimum": 0, "maximum": 64 },
+        "scale": { "$ref": "#/$defs/positiveNumberMap" }
+      }
+    },
+    "geometry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["radius", "borderWidth"],
+      "properties": {
+        "radius": { "$ref": "#/$defs/nonNegativeNumberMap" },
+        "borderWidth": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 16
+        }
+      }
+    },
+    "elevation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["shadows"],
+      "properties": {
+        "shadows": { "$ref": "#/$defs/stringMap" }
+      }
+    },
+    "density": { "enum": ["compact", "comfortable", "spacious"] },
+    "motion": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["enabled", "durationMs", "easing", "reducedMotion"],
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "durationMs": { "$ref": "#/$defs/nonNegativeNumberMap" },
+        "easing": { "$ref": "#/$defs/stringMap" },
+        "reducedMotion": { "const": "disable-nonessential" }
+      }
+    },
+    "diagrams": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["lineWidth", "nodeGap", "arrowStyle", "labelTreatment"],
+      "properties": {
+        "lineWidth": {
+          "type": "number",
+          "exclusiveMinimum": 0,
+          "maximum": 16
+        },
+        "nodeGap": {
+          "type": "number",
+          "exclusiveMinimum": 0,
+          "maximum": 512
+        },
+        "arrowStyle": { "enum": ["straight", "curved"] },
+        "labelTreatment": { "enum": ["inline", "boxed"] }
+      }
+    },
+    "bundleHash": {
+      "$ref": "#/$defs/hash",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    }
+  },
+  "$defs": {
+    "hash": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "color": {
+      "type": "string",
+      "pattern": "^#[0-9a-fA-F]{6}$"
+    },
+    "colors": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["surface", "ink", "accent", "status", "diagramSeries"],
+      "properties": {
+        "surface": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["canvas", "panel", "elevated"],
+          "properties": {
+            "canvas": { "$ref": "#/$defs/color" },
+            "panel": { "$ref": "#/$defs/color" },
+            "elevated": { "$ref": "#/$defs/color" }
+          }
+        },
+        "ink": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["primary", "muted", "inverse"],
+          "properties": {
+            "primary": { "$ref": "#/$defs/color" },
+            "muted": { "$ref": "#/$defs/color" },
+            "inverse": { "$ref": "#/$defs/color" }
+          }
+        },
+        "accent": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["primary", "secondary"],
+          "properties": {
+            "primary": { "$ref": "#/$defs/color" },
+            "secondary": { "$ref": "#/$defs/color" }
+          }
+        },
+        "status": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["success", "warning", "danger", "info"],
+          "properties": {
+            "success": { "$ref": "#/$defs/color" },
+            "warning": { "$ref": "#/$defs/color" },
+            "danger": { "$ref": "#/$defs/color" },
+            "info": { "$ref": "#/$defs/color" }
+          }
+        },
+        "diagramSeries": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/color" },
+          "minItems": 1,
+          "uniqueItems": true
+        }
+      }
+    },
+    "provenance": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["derived"],
+      "properties": {
+        "palette": { "type": "string", "minLength": 1 },
+        "visualProfile": { "type": "string", "minLength": 1 },
+        "derived": { "type": "boolean" },
+        "instructionHash": { "$ref": "#/$defs/hash" },
+        "suppliedBundleHash": { "$ref": "#/$defs/hash" }
+      }
+    },
+    "fontList": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 },
+      "minItems": 1
+    },
+    "stringMap": {
+      "type": "object",
+      "propertyNames": { "minLength": 1 },
+      "additionalProperties": { "type": "string", "minLength": 1 }
+    },
+    "positiveNumberMap": {
+      "type": "object",
+      "propertyNames": { "minLength": 1 },
+      "additionalProperties": {
+        "type": "number",
+        "exclusiveMinimum": 0,
+        "maximum": 1024
+      }
+    },
+    "nonNegativeNumberMap": {
+      "type": "object",
+      "propertyNames": { "minLength": 1 },
+      "additionalProperties": {
+        "type": "number",
+        "minimum": 0,
+        "maximum": 10000
+      }
+    }
+  }
+}