@open-agent-toolkit/cli 0.2.30 → 0.2.31

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

@@ -0,0 +1,241 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "explainer-kit.author-request/v3",
+  "title": "AuthorRequestV3",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "artifactId",
+    "artifactType",
+    "authoring",
+    "brief",
+    "visualAuthoringGuidance",
+    "factBase",
+    "theme",
+    "setContext",
+    "plannedArtifact",
+    "artifactLinks"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "explainer-kit.author-request/v3" },
+    "artifactId": { "type": "string", "minLength": 1 },
+    "artifactType": {
+      "enum": ["hub", "diagram", "explainer", "deck", "catalog"]
+    },
+    "authoring": { "enum": ["markdown", "html"] },
+    "brief": { "type": "string", "minLength": 1 },
+    "visualAuthoringGuidance": { "type": "string", "minLength": 1 },
+    "factBase": { "$ref": "explainer-kit.fact-base/v1" },
+    "shell": { "type": "string", "minLength": 1 },
+    "theme": { "$ref": "explainer-kit.theme/v1" },
+    "setContext": { "$ref": "explainer-kit.set-plan/v1" },
+    "plannedArtifact": { "$ref": "#/$defs/plannedArtifact" },
+    "artifactLinks": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/artifactLink" },
+      "minItems": 1,
+      "uniqueItems": true
+    },
+    "graphSemantics": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/graphSemantics" },
+      "minItems": 1
+    },
+    "floor": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["requiredNarrative"],
+      "properties": {
+        "requiredNarrative": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "minItems": 1,
+          "uniqueItems": true
+        }
+      }
+    }
+  },
+  "$defs": {
+    "artifactLink": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["artifactId", "artifactType", "sitePath", "href"],
+      "properties": {
+        "artifactId": {
+          "type": "string",
+          "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$"
+        },
+        "artifactType": {
+          "enum": ["hub", "diagram", "explainer", "deck", "catalog"]
+        },
+        "sitePath": {
+          "type": "string",
+          "pattern": "^site/[a-z0-9._-]+(?:/[a-z0-9._-]+)*/index\\.html$"
+        },
+        "href": {
+          "type": "string",
+          "pattern": "^(?:index\\.html|(?:\\.\\./)*[a-z0-9._-]+(?:/[a-z0-9._-]+)*/index\\.html)$"
+        }
+      }
+    },
+    "graphSemantics": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["direction", "nodes", "edges", "topology"],
+      "properties": {
+        "direction": { "enum": ["TD", "LR"] },
+        "nodes": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["id", "label", "shape", "explicit"],
+            "properties": {
+              "id": { "type": "string", "pattern": "^[A-Za-z][A-Za-z0-9_-]*$" },
+              "label": { "type": "string", "minLength": 1 },
+              "shape": { "enum": ["rectangle", "rounded", "diamond"] },
+              "explicit": { "type": "boolean" }
+            }
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "edges": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["from", "to", "kind", "label"],
+            "properties": {
+              "from": {
+                "type": "string",
+                "pattern": "^[A-Za-z][A-Za-z0-9_-]*$"
+              },
+              "to": { "type": "string", "pattern": "^[A-Za-z][A-Za-z0-9_-]*$" },
+              "kind": { "enum": ["arrow", "line"] },
+              "label": { "type": "string" }
+            }
+          },
+          "minItems": 1
+        },
+        "topology": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "kind",
+            "features",
+            "branchNodes",
+            "fanInNodes",
+            "cycle",
+            "order"
+          ],
+          "properties": {
+            "kind": { "const": "non-linear" },
+            "features": {
+              "type": "array",
+              "items": {
+                "enum": [
+                  "branch",
+                  "fan-in",
+                  "cycle",
+                  "disconnected",
+                  "non-linear"
+                ]
+              },
+              "minItems": 1,
+              "uniqueItems": true
+            },
+            "branchNodes": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "pattern": "^[A-Za-z][A-Za-z0-9_-]*$"
+              },
+              "uniqueItems": true
+            },
+            "fanInNodes": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "pattern": "^[A-Za-z][A-Za-z0-9_-]*$"
+              },
+              "uniqueItems": true
+            },
+            "cycle": { "type": "boolean" },
+            "order": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "pattern": "^[A-Za-z][A-Za-z0-9_-]*$"
+              },
+              "maxItems": 0
+            }
+          }
+        }
+      }
+    },
+    "plannedArtifact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "artifactId",
+        "artifactType",
+        "profileId",
+        "required",
+        "sourceIds",
+        "draft",
+        "visualIntent"
+      ],
+      "properties": {
+        "artifactId": {
+          "type": "string",
+          "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$"
+        },
+        "artifactType": {
+          "enum": ["hub", "diagram", "explainer", "deck", "catalog"]
+        },
+        "profileId": {
+          "type": "string",
+          "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$"
+        },
+        "required": { "type": "boolean" },
+        "sourceIds": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$"
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "draft": { "type": "string", "minLength": 1 },
+        "visualIntent": { "type": "string", "minLength": 1 },
+        "justification": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["kind", "sourceIds", "rationale"],
+          "properties": {
+            "kind": {
+              "enum": [
+                "status-change",
+                "rollout-complexity",
+                "source-backed-detail"
+              ]
+            },
+            "sourceIds": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$"
+              },
+              "minItems": 1,
+              "uniqueItems": true
+            },
+            "rationale": { "type": "string", "minLength": 1 }
+          }
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,215 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "explainer-kit.publish-receipt/v2",
+  "title": "PublishReceiptV2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "provider",
+    "publishedAt",
+    "publicAccess",
+    "roots",
+    "sentinel",
+    "artifacts"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "explainer-kit.publish-receipt/v2"
+    },
+    "provider": {
+      "const": "s3-static"
+    },
+    "publishedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "publicAccess": {
+      "enum": ["public", "protected"]
+    },
+    "roots": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["s3Uri", "publicBaseUrl"],
+      "properties": {
+        "s3Uri": {
+          "type": "string",
+          "pattern": "^s3://[a-z0-9][a-z0-9.-]{1,61}[a-z0-9](?:/[^\\s/?#\\\\]+(?:/[^\\s/?#\\\\]+)*)?$"
+        },
+        "publicBaseUrl": {
+          "type": "string",
+          "pattern": "^https://[^\\s/?#@]+(?::[0-9]+)?(?:/[^\\s/?#\\\\]+(?:/[^\\s/?#\\\\]+)*)?$"
+        }
+      }
+    },
+    "sentinel": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "relativePath",
+        "objectVerification",
+        "publicVerification",
+        "deleted"
+      ],
+      "properties": {
+        "relativePath": {
+          "$ref": "#/$defs/safeRelativePath"
+        },
+        "objectVerification": {
+          "$ref": "#/$defs/objectVerification"
+        },
+        "publicVerification": {
+          "$ref": "#/$defs/publicVerification"
+        },
+        "deleted": {
+          "type": "boolean"
+        }
+      }
+    },
+    "artifacts": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/artifact"
+      },
+      "uniqueItems": true
+    },
+    "publicRootPolicy": {
+      "description": "Present only when EXPLAINER_KIT_ALLOW_PRIVATE_PUBLIC_ROOT was set and the public root was in fact a non-public address, so a publication made with the anti-SSRF control disabled is distinguishable in durable evidence.",
+      "enum": ["private-allowed"]
+    }
+  },
+  "$defs": {
+    "hash": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "safeRelativePath": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$)).+$"
+    },
+    "source": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["kind", "artifactId"],
+          "properties": {
+            "kind": {
+              "const": "manifest"
+            },
+            "artifactId": {
+              "type": "string",
+              "minLength": 1
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["kind", "name"],
+          "properties": {
+            "kind": {
+              "const": "auxiliary"
+            },
+            "name": {
+              "type": "string",
+              "minLength": 1
+            }
+          }
+        }
+      ]
+    },
+    "objectVerification": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "method", "hash"],
+      "properties": {
+        "status": {
+          "const": "verified"
+        },
+        "method": {
+          "enum": ["service-checksum", "authenticated-download"]
+        },
+        "hash": {
+          "$ref": "#/$defs/hash"
+        }
+      }
+    },
+    "publicVerification": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["status", "httpStatus", "hash"],
+          "properties": {
+            "status": {
+              "const": "verified"
+            },
+            "httpStatus": {
+              "type": "integer",
+              "minimum": 200,
+              "maximum": 299
+            },
+            "hash": {
+              "$ref": "#/$defs/hash"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["status"],
+          "properties": {
+            "status": {
+              "const": "skipped-protected"
+            }
+          }
+        }
+      ]
+    },
+    "artifact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "source",
+        "relativePath",
+        "hash",
+        "s3Uri",
+        "publicUrl",
+        "contentType",
+        "objectVerification",
+        "publicVerification"
+      ],
+      "properties": {
+        "source": {
+          "$ref": "#/$defs/source"
+        },
+        "relativePath": {
+          "$ref": "#/$defs/safeRelativePath"
+        },
+        "hash": {
+          "$ref": "#/$defs/hash"
+        },
+        "s3Uri": {
+          "type": "string",
+          "pattern": "^s3://[a-z0-9][a-z0-9.-]{1,61}[a-z0-9]/[^\\s?#\\\\]+$"
+        },
+        "publicUrl": {
+          "type": "string",
+          "pattern": "^https://[^\\s/?#@]+(?::[0-9]+)?/[^\\s?#\\\\]+$"
+        },
+        "contentType": {
+          "type": "string",
+          "minLength": 1
+        },
+        "objectVerification": {
+          "$ref": "#/$defs/objectVerification"
+        },
+        "publicVerification": {
+          "$ref": "#/$defs/publicVerification"
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "explainer-kit.publish-request/v2",
+  "title": "S3StaticPublishRequestV2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "provider",
+    "s3Uri",
+    "publicBaseUrl",
+    "awsRegion",
+    "publicAccess",
+    "siteRoot",
+    "manifestPath"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "explainer-kit.publish-request/v2" },
+    "provider": { "const": "s3-static" },
+    "s3Uri": {
+      "type": "string",
+      "pattern": "^s3://[a-z0-9][a-z0-9.-]{1,61}[a-z0-9](?:/[^\\s/?#\\\\]+(?:/[^\\s/?#\\\\]+)*)?/?$"
+    },
+    "publicBaseUrl": {
+      "type": "string",
+      "pattern": "^https://[^\\s/?#@]+(?::[0-9]+)?(?:/[^\\s/?#\\\\]+(?:/[^\\s/?#\\\\]+)*)?/?$"
+    },
+    "awsRegion": { "type": "string", "minLength": 1 },
+    "awsProfile": { "type": "string", "minLength": 1 },
+    "publicAccess": { "enum": ["public", "protected"] },
+    "siteRoot": { "type": "string", "minLength": 1 },
+    "manifestPath": { "type": "string", "minLength": 1 }
+  }
+}

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

@@ -46,7 +46,10 @@
           "enum": ["none", "commit", "publish"]
         },
         "publish": {
-          "$ref": "explainer-kit.publish-request/v1"
+          "oneOf": [
+            { "$ref": "explainer-kit.publish-request/v1" },
+            { "$ref": "explainer-kit.publish-request/v2" }
+          ]
         }
       }
     },

package/assets/skills/explainer-kit/schemas/terminal-evidence.v1.schema.json

@@ -0,0 +1,81 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "explainer-kit.terminal-evidence/v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "runId",
+    "outcome",
+    "reasons",
+    "evidenceDisposition"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "explainer-kit.terminal-evidence/v1"
+    },
+    "runId": { "type": "string", "minLength": 1, "maxLength": 2000 },
+    "outcome": {
+      "enum": ["built-needs-review", "failed"]
+    },
+    "manifestHash": { "$ref": "#/$defs/hash" },
+    "reasons": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 50,
+      "items": { "$ref": "#/$defs/reason" }
+    },
+    "evidenceDisposition": {
+      "enum": ["retained", "partial", "unavailable", "superseded"]
+    },
+    "supersededBy": { "$ref": "#/$defs/supersededBy" }
+  },
+  "$defs": {
+    "hash": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "reason": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["stage", "kind", "count"],
+      "properties": {
+        "stage": {
+          "enum": [
+            "planning",
+            "authoring",
+            "rendering",
+            "link-validation",
+            "browser-review",
+            "visual-review",
+            "durability",
+            "finalization"
+          ]
+        },
+        "kind": {
+          "enum": [
+            "finding",
+            "provider-failure",
+            "pipeline-failure",
+            "superseded"
+          ]
+        },
+        "artifactId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 2000
+        },
+        "count": { "type": "integer", "minimum": 1, "maximum": 50 }
+      }
+    },
+    "supersededBy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["runId", "manifestHash"],
+      "properties": {
+        "runId": { "type": "string", "minLength": 1, "maxLength": 2000 },
+        "manifestHash": { "$ref": "#/$defs/hash" }
+      }
+    }
+  }
+}

package/assets/skills/explainer-kit/schemas/visual-review-evidence.v1.schema.json

@@ -0,0 +1,66 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "explainer-kit.visual-review-evidence/v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "requestHash",
+    "attempt",
+    "disposition",
+    "reasons"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "explainer-kit.visual-review-evidence/v1"
+    },
+    "requestHash": { "$ref": "#/$defs/hash" },
+    "attempt": { "enum": [1, 2] },
+    "disposition": { "enum": ["pass", "correct", "failed"] },
+    "reasons": {
+      "type": "array",
+      "minItems": 0,
+      "maxItems": 50,
+      "items": { "$ref": "#/$defs/reason" }
+    }
+  },
+  "$defs": {
+    "hash": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "reason": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["stage", "kind", "count"],
+      "properties": {
+        "stage": {
+          "enum": [
+            "planning",
+            "authoring",
+            "rendering",
+            "link-validation",
+            "browser-review",
+            "visual-review",
+            "durability",
+            "finalization"
+          ]
+        },
+        "kind": {
+          "enum": [
+            "finding",
+            "provider-failure",
+            "pipeline-failure",
+            "superseded"
+          ]
+        },
+        "artifactId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 2000
+        },
+        "count": { "type": "integer", "minimum": 1, "maximum": 50 }
+      }
+    }
+  }
+}