@remixmate/cli 0.9.72 → 0.9.73

package/skills/template-registry/scripts/render_job_client.py

@@ -1,15 +1,15 @@
 #!/usr/bin/env python3
-"""
-render_job_client.py — ab-api renderJob 接口 Python 客户端
 
-封装对 ab-api /api/renderJob/* 的调用，供 render_video.py 和
-gen_jianying_draft.py 使用。
 
-认证方式: X-Priv-Token header（与其他 skill 脚本一致）
-接口地址: 优先读 MM_API_BASE_URL（executor 显式转发、全链路标准名），
-         回退 MM_BACKEND_API_URL，再回退默认 https://api.remixmate.ai/api。
-         两个变量语义相同，保留回退是为兼容只配了其中一个的部署环境。
-"""
+
+
+
+
+
+
+
+
+
 
 from log_diagnostics import trace_headers
 import json
@@ -39,10 +39,10 @@ def _make_headers(priv_token: str) -> dict:
     return headers
 
 
-# ─── 扣费回传 ────────────────────────────────────────────────────────────────
-# ab-api 会在扣了积分的成功响应上挂 billing 字段（见 core.Success）。渲染积分是在
-# /renderJob/saveManifest 里扣的，所以这里是渲染花费唯一的可见入口——累加起来交给
-# render_video.py 在收尾时统一告知用户。
+
+
+
+
 _BILLING: dict = {"credits": 0, "balance": None}
 
 
@@ -60,12 +60,12 @@ def _record_billing(result: dict) -> None:
 
 
 def billing_summary() -> dict:
-    """本进程通过本模块产生的累计扣费：{"credits": int, "balance": int|None}。"""
+
     return dict(_BILLING)
 
 
 def _post(path: str, payload: dict, priv_token: str, timeout: int = 30) -> dict:
-    """发送 POST 请求并返回响应 data 字段；失败时抛出 RuntimeError。"""
+
     url = f"{_api_base()}{path}"
     body = json.dumps(payload).encode("utf-8")
     req = urllib.request.Request(url, data=body, headers=_make_headers(priv_token), method="POST")
@@ -86,33 +86,33 @@ def _post(path: str, payload: dict, priv_token: str, timeout: int = 30) -> dict:
     return result.get("data") or {}
 
 
-# ─────────────────────────────────────────────────────────────────────────────
+
 
 
 def create_job(priv_token: str, dsl: str = "", dsl_meta: dict = None) -> int:
-    """
-    创建渲染任务。
 
-    会话归属：本函数会自动带上环境变量 CONVERSATION_ID（若已设置），让服务端在
-    创建时就把 job 挂到该会话的 take 上。
 
-    为什么要在这里传：渲染任务过去出生就是孤儿——归属全靠事后一次独立的补绑调用，
-    而那条路上有四个静默盲区（CLI 的 take 绑定在 job 出生前就跑完了；云端因为
-    CONVERSATION_ID 已被注入而整段跳过它；兜底补绑的 jobId 末位来源是从 stdout
-    正则抠的）。归属断了，成片在旁白面板里就查不到已生成的音频。
-    而 CONVERSATION_ID 在这一刻本来就已经在环境里了——信息在场，以前只是没传。
-    见 ab-platform/docs/engineering/render-job-binding-fix.md。
 
-    服务端对该字段是软失败：绑不上只记日志，不影响任务创建。
 
-    Args:
-        priv_token: PrivToken
-        dsl: 完整 DSL JSON 字符串（可选）
-        dsl_meta: DSL 摘要字典（可选，将被序列化为 JSON）
 
-    Returns:
-        jobId (int)
-    """
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
     payload: dict = {}
     if dsl:
         payload["dsl"] = dsl
@@ -131,28 +131,28 @@ def create_job(priv_token: str, dsl: str = "", dsl_meta: dict = None) -> int:
 
 
 def save_plan(job_id: int, render_plan: str, priv_token: str) -> None:
-    """
-    保存 RenderPlan 到数据库（Phase 1 完成后调用）。
-
-    Args:
-        job_id: 渲染任务 ID
-        render_plan: 完整 RenderPlan JSON 字符串
-        priv_token: PrivToken
-    """
+
+
+
+
+
+
+
+
     _post("/renderJob/savePlan", {"jobId": job_id, "renderPlan": render_plan}, priv_token)
 
 
 def get_plan(job_id: int, priv_token: str) -> str:
-    """
-    从数据库加载 RenderPlan（Phase 2 开始前调用）。
 
-    Args:
-        job_id: 渲染任务 ID
-        priv_token: PrivToken
 
-    Returns:
-        RenderPlan JSON 字符串
-    """
+
+
+
+
+
+
+
+
     data = _post("/renderJob/getPlan", {"jobId": job_id}, priv_token)
     render_plan = data.get("renderPlan")
     if not render_plan:
@@ -161,28 +161,28 @@ def get_plan(job_id: int, priv_token: str) -> str:
 
 
 def save_manifest(job_id: int, manifest: dict, priv_token: str) -> None:
-    """
-    保存渲染结果到数据库（渲染完成后调用）。
-
-    Args:
-        job_id: 渲染任务 ID
-        manifest: 渲染结果字典
-        priv_token: PrivToken
-    """
+
+
+
+
+
+
+
+
     _post("/renderJob/saveManifest", {"jobId": job_id, "manifest": manifest}, priv_token)
 
 
 def latest_job(conversation_id: str, priv_token: str) -> dict:
-    """
-    按会话取最近一次**已存 RenderPlan** 的渲染任务摘要（POST /renderJob/latest）。
 
-    多轮对话里模型看不到之前的工具结果，拿不到 jobId；消费上一轮成果的 skill
-    （如 export-jianying）用注入的 CONVERSATION_ID 反查最新一版，而不是让模型从
-    聊天记录里拼素材 URL —— 那样会拿到过期的旧版素材。
 
-    Returns:
-        {"jobId": int, "status": str, "attempt": int, "createTime": str, "updateTime": str}
-    """
+
+
+
+
+
+
+
+
     data = _post("/renderJob/latest", {"conversationId": conversation_id}, priv_token)
     if not data.get("jobId"):
         raise RuntimeError("no render job with a saved RenderPlan in this conversation")
@@ -190,20 +190,20 @@ def latest_job(conversation_id: str, priv_token: str) -> dict:
 
 
 def get_job(job_id: int, priv_token: str) -> dict:
-    """
-    获取渲染任务完整详情。
 
-    Args:
-        job_id: 渲染任务 ID
-        priv_token: PrivToken
 
-    Returns:
-        任务详情字典（含 status / renderPlan / manifest 等）
-    """
+
+
+
+
+
+
+
+
     return _post("/renderJob/get", {"jobId": job_id}, priv_token)
 
 
-# ─── CLI self-test ────────────────────────────────────────────────────────────
+
 
 if __name__ == "__main__":
     import argparse

package/skills/template-registry/scripts/showcase_loader.py

@@ -1,32 +1,32 @@
-"""Showcase (sample video) loader — per-template samples + web detail-page links.
 
-Used by ``list_templates.py`` so an agent host (Codex CLI / Codex Desktop /
-Claude Code) can show the user how many samples a template has and a link to
-the web detail page where the samples play.
 
-Contract (ab-api ``POST /templateShowcase/listByTemplate``, X-Priv-Token):
 
-    request  {"templateKeys": [...], "limitPerTemplate": N}
-    response {code, msg, data: {"templates": [
-                {"templateKey", "pageUrl"?, "showcaseCount",
-                 "showcases": [{"showcaseId", "name", "coverImage", "videoUrl",
-                                "aspectRatio", "duration", "hasDemo", "pageUrl"?, ...}]}
-             ]}}
 
-Links are built server-side; the CLI never knows the web origin or routes.
 
-Unlike the registry, samples are *enhancement* data: every failure (network,
-older ab-api without the endpoint, business error, bad JSON) returns ``None``
-with one stderr warning, and the caller keeps printing the template list.
-Auth failures are also degraded here — the registry call that precedes this
-one already surfaces them with the proper exit code.
 
-Env:
-  VIDEO_TEMPLATE_SHOWCASE_URL   explicit endpoint (tests point it at file://)
-  MM_API_BASE_URL / MM_BACKEND_API_URL   base, same resolution as the registry
-  PRIV_TOKEN                    injected by the CLI runner
-  VIDEO_TEMPLATE_REGISTRY_CACHE_DIR      shared cache dir
-"""
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 
 from __future__ import annotations
 
@@ -41,14 +41,14 @@ from typing import Optional
 
 from registry_loader import api_base_url
 
-# Never longer than the registry TTL: a sample added in ShowcaseManager should
-# show up about as fast as a template change does.
+
+
 _TTL_SECONDS = 300
 _HTTP_TIMEOUT = 5
 
-# Item fields kept in CLI output. The endpoint returns the full wizard item
-# (replicateConfig, layoutPreview, tags …) for the web; an agent only needs
-# enough to describe and link a sample.
+
+
+
 SUMMARY_ITEM_FIELDS = (
     "showcaseId", "name", "coverImage", "videoUrl",
     "aspectRatio", "duration", "hasDemo", "pageUrl",
@@ -56,12 +56,12 @@ SUMMARY_ITEM_FIELDS = (
 
 
 def _endpoint() -> str:
-    """Endpoint URL, or "" when samples should not be fetched at all.
 
-    An offline registry (``VIDEO_TEMPLATE_REGISTRY_URL=file://…``, fixtures /
-    air-gapped dev) never implies a network call for samples: the registry
-    there is not ab-api's, so neither are its templates.
-    """
+
+
+
+
+
     explicit = os.environ.get("VIDEO_TEMPLATE_SHOWCASE_URL", "").strip()
     if explicit:
         return explicit
@@ -78,8 +78,8 @@ def _cache_dir() -> str:
 
 
 def _cache_file(url: str, body: bytes, token: str) -> str:
-    # Token identity is part of the key (hashed twice, never stored): two
-    # accounts on one machine see different private templates.
+
+
     token_id = hashlib.sha256(token.encode("utf-8")).hexdigest()[:8]
     digest = hashlib.sha256(url.encode("utf-8") + b"\0" + body + b"\0" + token_id.encode()).hexdigest()[:16]
     return os.path.join(_cache_dir(), f"showcases-{digest}.json")
@@ -104,7 +104,7 @@ def _write_cache(path: str, data: dict) -> None:
             json.dump({"fetchedAt": time.time(), "data": data}, fh, ensure_ascii=False)
         os.replace(tmp, path)
     except OSError:
-        pass  # cache is best-effort
+        pass
 
 
 def _warn(reason: str) -> None:
@@ -112,18 +112,18 @@ def _warn(reason: str) -> None:
 
 
 def load_showcases(template_keys: list[str], limit_per_template: int) -> Optional[dict[str, dict]]:
-    """Return ``{templateKey: group}`` for the visible templates, or ``None`` on any failure.
 
-    Templates the caller cannot see are simply absent from the dict.
-    """
+
+
+
     keys = [k for k in dict.fromkeys(template_keys) if isinstance(k, str) and k]
     if not keys:
         return {}
 
     url = _endpoint()
     token = os.environ.get("PRIV_TOKEN", "").strip()
-    # Silent skips (not failures): offline registry, or no credential — the
-    # endpoint is authenticated and the registry step already reported auth.
+
+
     if not url or (not token and not url.startswith("file://")):
         return None
     body = json.dumps(
@@ -141,8 +141,8 @@ def load_showcases(template_keys: list[str], limit_per_template: int) -> Optiona
         try:
             with urllib.request.urlopen(req, timeout=_HTTP_TIMEOUT) as resp:
                 parsed = json.loads(resp.read().decode("utf-8"))
-        except Exception as exc:  # noqa: BLE001 — enhancement data, degrade on anything
-            # Message only: exception text never includes the token header.
+        except Exception as exc:
+
             _warn(type(exc).__name__ + (f" {exc.code}" if hasattr(exc, "code") else ""))
             return None
         if not isinstance(parsed, dict) or parsed.get("code") not in (0, "0"):
@@ -164,7 +164,7 @@ def load_showcases(template_keys: list[str], limit_per_template: int) -> Optiona
 
 
 def summarize_group(group: dict, max_items: int) -> dict:
-    """The CLI's view of one template's samples: count, link, a few slim items."""
+
     items = []
     for sc in (group.get("showcases") or [])[:max_items]:
         if isinstance(sc, dict):

package/skills/template-registry/skill.json

@@ -18,8 +18,11 @@
       "filter_tag": { "type": "string", "description": "Show only templates whose styleTags contain (or are contained in) this string. Case-insensitive. E.g. 'tech' / '科普' / 'walkthrough'." },
       "filter_aspect": { "type": "string", "description": "Show only templates that declare this aspect ratio. E.g. '9:16' / '16:9' / '1:1'." },
       "filter_language": { "type": "string", "description": "Show only templates whose contentLanguage includes this code ('zh' or 'en'). Templates with no declared language are always shown (treated as language-agnostic)." },
+      "user_media": { "type": "string", "enum": ["yes", "no"], "description": "Shortlisting when the user named no template. 'yes' = the user handed over their own images/videos: drops templates with nowhere to put them. 'no' = they did not: drops templates that cannot run without them. Leave unset when it does not matter." },
+      "source_doc": { "type": "string", "description": "Shortlisting: the user gave a source document of this kind (e.g. 'pptx') — keeps only templates that build their scenes from one. 'none' drops those templates. Leave unset otherwise." },
+      "narration": { "type": "string", "enum": ["yes", "no"], "description": "Shortlisting: 'yes' = the video needs voice-over (drops narration-free templates); 'no' = the user wants none (keeps only narration-free templates). Leave unset unless the user said so." },
       "include_beta": { "type": "boolean", "description": "Also list templates with status='beta'. Default off (only 'stable' shows). The ENABLE_BETA_TEMPLATES env var has the same effect process-wide." },
-      "json_output": { "type": "boolean", "description": "Emit a JSON result instead of the human-readable table: { templates: [...] } — summaries, or full definitions when template_id / full is set — or { examples: [...] }. List summaries carry pageUrl (the template's web detail page — show it to the user as a link) and, when the backend serves samples, showcases { count, pageUrl, items }; the template_id view carries top-level pageUrls / showcases maps." },
+      "json_output": { "type": "boolean", "description": "Emit a JSON result instead of the human-readable table: { templates: [...] } — summaries (each with notFor when the template declares which requests it is the wrong pick for), or full definitions when template_id / full is set — or { examples: [...] }. List summaries carry pageUrl (the template's web detail page — show it to the user as a link) and, when the backend serves samples, showcases { count, pageUrl, items }; the template_id view carries top-level pageUrls / showcases maps." },
       "open": { "type": "string", "description": "Print the web detail page URL of <templateId> (playable samples, layouts, copy-ready prompt) and open it in the browser when run from an interactive terminal. Relay the printed URL to the user." }
     },
     "required": []

package/skills/template-registry/version.json

@@ -2,6 +2,6 @@
   "skillName": "template-registry",
   "repoName": "agent-skill-media-maker",
   "skillId": "475",
-  "version": "V27",
+  "version": "V28",
   "skillDescription": "Video-template registry skill. Stores every video-template definition and lists the available templates (templateId / name / aspect ratio / style tags).\n\nUse this skill as soon as the user mentions any of these intents:\n- View available templates / list every template\n\nNote: DSL→TemplateBinding is no longer a separate exposed step — once prepare_video_assets receives a template_id it builds the binding internally."
 }

package/skills/template-registry/video_dsl/runtime/__init__.py

@@ -1,10 +1,10 @@
-"""Package marker for ``video_dsl.runtime`` — kept intentionally empty.
 
-This file exists so ``from video_dsl.runtime.<mod> import …`` resolves when
-``skills/template-registry/`` is on sys.path (the pattern used by render-video
-and gen-script). Public modules:
 
-    - timeline_compiler  : DSL → Remotion frame-axis timeline + subtitle splits
-    - prompt_enhancer    : LLM image-prompt enrichment used by gen-script
-    - dsl_validator      : DSL validation (structural / integrity / full presets)
-"""
+
+
+
+
+
+
+
+