hyper-animator-codex 0.7.0 → 0.8.0

package/skills/hyper-animator-codex/contracts/shot-plan.schema.json

@@ -0,0 +1,214 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://hyper-animator-codex.local/contracts/shot-plan.schema.json",
+  "title": "Hyper Animator dual-catalog shot plan",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "generation_mode",
+    "catalog_strategy",
+    "dimensions",
+    "duration_seconds",
+    "audio",
+    "model_routing",
+    "shots"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "1.0.0"
+    },
+    "generation_mode": {
+      "enum": [
+        "assemble_existing_catalog_items",
+        "generate_new_hyperframes_html"
+      ]
+    },
+    "catalog_strategy": {
+      "const": "dual_catalog"
+    },
+    "dimensions": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "width",
+        "height"
+      ],
+      "properties": {
+        "width": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "height": {
+          "type": "integer",
+          "minimum": 1
+        }
+      }
+    },
+    "duration_seconds": {
+      "type": "number",
+      "exclusiveMinimum": 0
+    },
+    "audio": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "narration",
+        "bgm"
+      ],
+      "properties": {
+        "narration": {
+          "$ref": "#/$defs/audioTrack"
+        },
+        "bgm": {
+          "$ref": "#/$defs/audioTrack"
+        }
+      }
+    },
+    "model_routing": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "page_animation_authoring",
+        "planning_and_validation"
+      ],
+      "properties": {
+        "page_animation_authoring": {
+          "const": "gpt-5.6-sol"
+        },
+        "planning_and_validation": {
+          "not": {
+            "const": "gpt-5.6-sol"
+          }
+        }
+      }
+    },
+    "shots": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "$ref": "#/$defs/shot"
+      }
+    },
+    "assumptions": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    }
+  },
+  "$defs": {
+    "audioTrack": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "mode"
+      ],
+      "properties": {
+        "mode": {
+          "enum": [
+            "generated",
+            "user_local_file",
+            "none"
+          ]
+        },
+        "provider": {
+          "enum": [
+            "minimax_cn"
+          ]
+        },
+        "path": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "mode": {
+                "const": "generated"
+              }
+            }
+          },
+          "then": {
+            "required": [
+              "provider"
+            ],
+            "properties": {
+              "provider": {
+                "const": "minimax_cn"
+              }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "mode": {
+                "const": "user_local_file"
+              }
+            }
+          },
+          "then": {
+            "required": [
+              "path"
+            ]
+          }
+        }
+      ]
+    },
+    "shot": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "start_seconds",
+        "end_seconds",
+        "purpose",
+        "hyperframes_refs",
+        "shotcraft_refs"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*$"
+        },
+        "start_seconds": {
+          "type": "number",
+          "minimum": 0
+        },
+        "end_seconds": {
+          "type": "number",
+          "exclusiveMinimum": 0
+        },
+        "purpose": {
+          "type": "string",
+          "minLength": 1
+        },
+        "hyperframes_refs": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "uniqueItems": true
+        },
+        "shotcraft_refs": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "uniqueItems": true
+        },
+        "narration_scene": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      }
+    }
+  }
+}

package/skills/hyper-animator-codex/contracts/workflow-policy.json

@@ -0,0 +1,85 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "schema_version": "1.0.0",
+  "audio": {
+    "generated_narration": {
+      "provider": "minimax_cn",
+      "endpoint": "https://api.minimaxi.com/v1/t2a_v2",
+      "backup_endpoints": [
+        "https://api-bj.minimaxi.com/v1/t2a_v2"
+      ],
+      "voice_endpoint": "https://api.minimaxi.com/v1/get_voice",
+      "voice_backup_endpoints": [
+        "https://api-bj.minimaxi.com/v1/get_voice"
+      ],
+      "script": "scripts/generate_minimax_tts.mjs"
+    },
+    "generated_bgm": {
+      "provider": "minimax_cn",
+      "endpoint": "https://api.minimaxi.com/v1/music_generation",
+      "script": "scripts/generate_minimax_music.mjs"
+    },
+    "forbidden_providers": [
+      "heygen",
+      "kokoro",
+      "musicgen"
+    ],
+    "forbidden_commands": [
+      "hyperframes auth login",
+      "hyperframes tts"
+    ],
+    "automatic_fallback": false,
+    "automatic_runtime_install": false,
+    "failure_choices": [
+      "retry_minimax_cn",
+      "use_user_local_file",
+      "skip_track"
+    ],
+    "endpoint_override": {
+      "production": false,
+      "test_env_flag": "MINIMAX_ALLOW_TEST_ENDPOINT"
+    }
+  },
+  "model_routing": {
+    "page_animation_authoring": {
+      "model": "gpt-5.6-sol",
+      "use_for": [
+        "page_generation",
+        "animation_authoring"
+      ]
+    },
+    "planning_and_validation": {
+      "model": "gpt-5.6-terra",
+      "use_for": [
+        "requirements",
+        "file_detection",
+        "catalog_query",
+        "shot_planning",
+        "audio_prompting",
+        "validation",
+        "packaging"
+      ]
+    }
+  },
+  "shotcraft": {
+    "role": "reference_knowledge",
+    "catalog_strategy": "dual_catalog",
+    "catalog_path": "references/shotcraft/catalog.json",
+    "query_script": "scripts/query_shotcraft.mjs",
+    "default_statuses": [
+      "implemented"
+    ],
+    "excluded_asset_extensions": [
+      ".mp4",
+      ".mov",
+      ".mp3",
+      ".wav",
+      ".m4a",
+      ".png",
+      ".jpg",
+      ".jpeg",
+      ".webp",
+      ".gif"
+    ]
+  }
+}