hyper-animator-codex 0.2.0 → 0.4.0

package/skills/hyper-animator-codex/scripts/minimax_runtime_config.mjs

@@ -0,0 +1,113 @@
+import { readFile, stat } from "node:fs/promises";
+import { join } from "node:path";
+
+export const DEFAULT_MINIMAX_MODEL = "music-2.6-free";
+export const TEXT_MUSIC_MODELS = new Set(["music-2.6", "music-2.6-free"]);
+
+async function pathExists(path) {
+  try {
+    await stat(path);
+    return true;
+  } catch (error) {
+    if (error && error.code === "ENOENT") {
+      return false;
+    }
+    throw error;
+  }
+}
+
+function cleanString(value) {
+  if (typeof value !== "string") {
+    return undefined;
+  }
+
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : undefined;
+}
+
+function normalize(input = {}) {
+  return {
+    api_key: cleanString(input.api_key),
+    group_id: cleanString(input.group_id),
+    model: cleanString(input.model),
+  };
+}
+
+function hasValues(input = {}) {
+  return Boolean(cleanString(input.api_key) || cleanString(input.group_id) || cleanString(input.model));
+}
+
+export function redactMinimaxConfig(config = {}) {
+  const normalized = normalize(config);
+
+  return {
+    api_key: normalized.api_key ? "[redacted]" : undefined,
+    group_id: normalized.group_id,
+    model: normalized.model || DEFAULT_MINIMAX_MODEL,
+  };
+}
+
+export function validateMinimaxConfig(config = {}) {
+  const normalized = normalize(config);
+
+  if (!normalized.api_key) {
+    throw new Error("MiniMax api_key is required");
+  }
+
+  if (!normalized.group_id) {
+    throw new Error("MiniMax group_id is required");
+  }
+
+  const model = normalized.model || DEFAULT_MINIMAX_MODEL;
+
+  if (!TEXT_MUSIC_MODELS.has(model)) {
+    throw new Error(`Unsupported MiniMax text music model: ${model}. Use music-2.6 or music-2.6-free.`);
+  }
+
+  return {
+    api_key: normalized.api_key,
+    group_id: normalized.group_id,
+    model,
+  };
+}
+
+async function readJson(path) {
+  const raw = await readFile(path, "utf8");
+  const parsed = JSON.parse(raw);
+
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error(`MiniMax config file must be a JSON object: ${path}`);
+  }
+
+  return parsed;
+}
+
+export async function readMinimaxRuntimeConfig({ skillRoot, env = process.env, configPath } = {}) {
+  const explicitConfigPath = cleanString(configPath);
+  const defaultConfigPath = skillRoot ? join(skillRoot, "config", "minimax.json") : undefined;
+  const filePath = explicitConfigPath || defaultConfigPath;
+
+  if (filePath && await pathExists(filePath)) {
+    return {
+      source: "file",
+      configPath: filePath,
+      config: validateMinimaxConfig(await readJson(filePath)),
+    };
+  }
+
+  const envConfig = normalize({
+    api_key: env.MINIMAX_API_KEY,
+    group_id: env.MINIMAX_GROUP_ID,
+    model: env.MINIMAX_MODEL,
+  });
+
+  if (!hasValues(envConfig)) {
+    return null;
+  }
+
+  return {
+    source: "environment",
+    configPath: null,
+    config: validateMinimaxConfig(envConfig),
+  };
+}

package/skills/hyper-animator-codex/scripts/validate_hyperframes_html.py

@@ -13,7 +13,12 @@ def has_attr(html: str, name: str) -> bool:
     return re.search(rf"\b{name}\s*=\s*['\"]?[^'\"\s>]+", html, re.IGNORECASE) is not None
 
 
-def check_html(html: str, *, component: bool = False) -> tuple[list[str], list[str]]:
+def check_html(
+    html: str,
+    *,
+    component: bool = False,
+    preview_controls: bool = False,
+) -> tuple[list[str], list[str]]:
     failures: list[str] = []
     warnings: list[str] = []
 
@@ -51,6 +56,24 @@ def check_html(html: str, *, component: bool = False) -> tuple[list[str], list[s
     if len(re.findall(r"data-duration\s*=\s*['\"]?(\d+(?:\.\d+)?)", html)) > 1:
         warnings.append("multiple data-duration values found; verify the intended render duration")
 
+    if preview_controls:
+        if "data-hyper-preview-ui" not in html:
+            failures.append("missing preview controls: data-hyper-preview-ui")
+        if "data-hyper-preview-page" not in html:
+            failures.append("missing preview controls: page indicator")
+        if "data-hyper-preview-progress" not in html:
+            failures.append("missing preview controls: progress input")
+        if not re.search(r"<input[^>]+type=[\"']range[\"']", html, re.IGNORECASE | re.DOTALL):
+            failures.append("missing preview controls: range input")
+        if "ArrowLeft" not in html or "ArrowRight" not in html:
+            failures.append("missing preview controls: left/right keyboard handlers")
+        if 'params.get("render") === "1"' not in html:
+            failures.append("missing preview controls: ?render=1 hidden-mode check")
+        if 'params.get("preview") === "0"' not in html:
+            failures.append("missing preview controls: ?preview=0 hidden-mode check")
+        if 'dataset.renderMode === "video"' not in html:
+            failures.append("missing preview controls: data-render-mode video hidden-mode check")
+
     return failures, warnings
 
 
@@ -62,6 +85,11 @@ def main() -> int:
         action="store_true",
         help="Validate a component snippet instead of a full block composition",
     )
+    parser.add_argument(
+        "--preview-controls",
+        action="store_true",
+        help="Require injected Hyper Animator preview controls",
+    )
     args = parser.parse_args()
 
     path = Path(args.html_file)
@@ -70,7 +98,11 @@ def main() -> int:
         return 2
 
     html = path.read_text(encoding="utf-8")
-    failures, warnings = check_html(html, component=args.component)
+    failures, warnings = check_html(
+        html,
+        component=args.component,
+        preview_controls=args.preview_controls,
+    )
 
     for warning in warnings:
         print(f"WARN: {warning}", file=sys.stderr)