janction-render 0.4.1__tar.gz → 0.4.3__tar.gz

{janction_render-0.4.1 → janction_render-0.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: janction-render
-Version: 0.4.1
+Version: 0.4.3
 Summary: Cloud GPU render farm for Blender, for AI agents: MCP server (remote + stdio) and CLI. Render Blender without a GPU from Claude, ChatGPT, Claude Code, Codex, Cursor.
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -37,6 +37,9 @@ without a GPU, or when rendering locally is slow.
 - In hosts that support MCP Apps (Claude web and desktop, among others), previews, progress and download links also appear
   as an interactive panel in the chat: the image, a progress bar, "Open MP4", and preset buttons after an `environment="compare"` preview.
   Both the remote connector and the stdio package ship the panel (`janction_render/mcp_app.html`); set `JR_MCP_APPS=0` to turn it off.
+- CC0 assets by name: `asset_search("wooden table")` finds Poly Haven models, textures and HDRIs; pass `polyhaven:<id>` in
+  `asset_urls` (remote) or `assets` (stdio) and the files land in `JR_ASSETS_DIR/<id>/` on the GPU, ready to import
+  (`bpy.ops.import_scene.gltf(filepath=os.path.join(os.environ['JR_ASSETS_DIR'], 'wooden_table_02', 'wooden_table_02_1k.gltf'))`).
 - `scene_info` reads the scene without rendering (cameras, frame range, missing files).
 - `render_preview` returns 1-4 low-cost frames tiled in one image within seconds, so the agent can look, fix, and repeat.
 - `render_estimate` says how long a render will take ("about 3 minutes") and whether it fits today's free quota.
@@ -116,9 +119,10 @@ Then, in Claude Code:
 | `scene_info(scene_script | scene_url | scene_path | scene_id, assets?)` | cameras, frame range, fps, resolution, objects, lights, missing files. No render. |
 | `render_preview(..., frames="1-24", environment?, blender?)` | up to 4 frames (720p budget) tiled with frame labels; returns the image inline |
 | `render_estimate(scene_id, frame_start, frame_end, width, height, samples)` | GPU seconds, queue wait, "about N minutes", fits today's free quota? No GPU time used |
-| `render_final(scene_id, frame_start, frame_end, width, height, samples, fps, output, environment?, blender?, engine?)` | frames (png / exr) or video (mp4 / webm / prores); returns job_id + estimate |
+| `render_final(scene_id, frame_start, frame_end, width, height, samples, fps, output, environment?, blender?, engine?, transparent?, notify_url?)` | frames (png / exr) or video (mp4 / webm / prores / gif / webp); `transparent=True` keeps an alpha background (png / exr / webm / gif / webp); `notify_url` gets one JSON POST when the job finishes; returns job_id + estimate |
 | `render_status(job_id)` | progress and ETA (`eta.human`); `render_download(job_id, only="mp4" / "frames" / "all")` files or links; `render_cancel(job_id)` |
 | `billing()` | free-beta quota (used today, daily limit, reset time); later balance and top-up link |
+| `asset_search(query, kind)` | CC0 models / textures / HDRIs on Poly Haven by words; results carry `polyhaven:<id>` and the entry file |
 | `render_info()` | workers online or gated (GPU lent to another workload), queue, expected wait, supported inputs, environment presets, Blender versions |
 
 Options on `render_preview` / `render_final`: `environment` (`studio`, `sunset`, `overcast`, `night`, `compare` on previews; `environment_strength`,
@@ -155,10 +159,12 @@ POST /v1/keys                                   -> {api_key}         (header X-A
 POST /v1/files  multipart "file" (.blend|.py|.glb|.fbx|.usd|.obj|...)   -> {scene_id}
 POST /v1/files/{id}/assets  multipart "files"   textures, glTF .bin ...   GET /v1/files/lookup?sha256=  reuse an upload
 POST /v1/estimate {kind, frames|frame_start/frame_end, width, height, samples, scene_id?} -> seconds, wall_seconds, human, quota
-POST /v1/jobs   {scene_id, kind: info|preview|final, frames|frame_start/frame_end, width, height, samples, camera, fps, output (png|exr|mp4|webm|prores), engine (cycles|eevee),
+POST /v1/jobs   {scene_id, kind: info|preview|final, frames|frame_start/frame_end, width, height, samples, camera, fps, output (png|exr|mp4|webm|prores|gif|webp), transparent, notify_url (https), engine (cycles|eevee),
                  environment, environment_strength, environment_visible, blender, orbit, orbit_frames, orbit_elevation}
 GET  /v1/jobs/{id}      status, progress, eta, artifacts[], cost, warnings, info    DELETE /v1/jobs/{id}  cancel
 GET  /v1/jobs/{id}/artifacts/{name}             PNG / MP4
+GET  /v1/assets/search?q=&kind=models|textures|hdris   CC0 assets (Poly Haven) -> spec polyhaven:<id>
+POST /v1/files/{id}/assets/urls {urls: ["https://...", "polyhaven:<id>"]}   fetch assets server-side
 POST /mcp                                       remote MCP (Streamable HTTP; Bearer api key or OAuth)
 GET  /.well-known/oauth-protected-resource/mcp  OAuth discovery
 POST /v1/billing/checkout {amount_yen} -> {checkout_url}   POST /v1/billing/sync   GET /v1/ledger   GET /v1/me

{janction_render-0.4.1 → janction_render-0.4.3}/README.md

@@ -20,6 +20,9 @@ without a GPU, or when rendering locally is slow.
 - In hosts that support MCP Apps (Claude web and desktop, among others), previews, progress and download links also appear
   as an interactive panel in the chat: the image, a progress bar, "Open MP4", and preset buttons after an `environment="compare"` preview.
   Both the remote connector and the stdio package ship the panel (`janction_render/mcp_app.html`); set `JR_MCP_APPS=0` to turn it off.
+- CC0 assets by name: `asset_search("wooden table")` finds Poly Haven models, textures and HDRIs; pass `polyhaven:<id>` in
+  `asset_urls` (remote) or `assets` (stdio) and the files land in `JR_ASSETS_DIR/<id>/` on the GPU, ready to import
+  (`bpy.ops.import_scene.gltf(filepath=os.path.join(os.environ['JR_ASSETS_DIR'], 'wooden_table_02', 'wooden_table_02_1k.gltf'))`).
 - `scene_info` reads the scene without rendering (cameras, frame range, missing files).
 - `render_preview` returns 1-4 low-cost frames tiled in one image within seconds, so the agent can look, fix, and repeat.
 - `render_estimate` says how long a render will take ("about 3 minutes") and whether it fits today's free quota.
@@ -99,9 +102,10 @@ Then, in Claude Code:
 | `scene_info(scene_script | scene_url | scene_path | scene_id, assets?)` | cameras, frame range, fps, resolution, objects, lights, missing files. No render. |
 | `render_preview(..., frames="1-24", environment?, blender?)` | up to 4 frames (720p budget) tiled with frame labels; returns the image inline |
 | `render_estimate(scene_id, frame_start, frame_end, width, height, samples)` | GPU seconds, queue wait, "about N minutes", fits today's free quota? No GPU time used |
-| `render_final(scene_id, frame_start, frame_end, width, height, samples, fps, output, environment?, blender?, engine?)` | frames (png / exr) or video (mp4 / webm / prores); returns job_id + estimate |
+| `render_final(scene_id, frame_start, frame_end, width, height, samples, fps, output, environment?, blender?, engine?, transparent?, notify_url?)` | frames (png / exr) or video (mp4 / webm / prores / gif / webp); `transparent=True` keeps an alpha background (png / exr / webm / gif / webp); `notify_url` gets one JSON POST when the job finishes; returns job_id + estimate |
 | `render_status(job_id)` | progress and ETA (`eta.human`); `render_download(job_id, only="mp4" / "frames" / "all")` files or links; `render_cancel(job_id)` |
 | `billing()` | free-beta quota (used today, daily limit, reset time); later balance and top-up link |
+| `asset_search(query, kind)` | CC0 models / textures / HDRIs on Poly Haven by words; results carry `polyhaven:<id>` and the entry file |
 | `render_info()` | workers online or gated (GPU lent to another workload), queue, expected wait, supported inputs, environment presets, Blender versions |
 
 Options on `render_preview` / `render_final`: `environment` (`studio`, `sunset`, `overcast`, `night`, `compare` on previews; `environment_strength`,
@@ -138,10 +142,12 @@ POST /v1/keys                                   -> {api_key}         (header X-A
 POST /v1/files  multipart "file" (.blend|.py|.glb|.fbx|.usd|.obj|...)   -> {scene_id}
 POST /v1/files/{id}/assets  multipart "files"   textures, glTF .bin ...   GET /v1/files/lookup?sha256=  reuse an upload
 POST /v1/estimate {kind, frames|frame_start/frame_end, width, height, samples, scene_id?} -> seconds, wall_seconds, human, quota
-POST /v1/jobs   {scene_id, kind: info|preview|final, frames|frame_start/frame_end, width, height, samples, camera, fps, output (png|exr|mp4|webm|prores), engine (cycles|eevee),
+POST /v1/jobs   {scene_id, kind: info|preview|final, frames|frame_start/frame_end, width, height, samples, camera, fps, output (png|exr|mp4|webm|prores|gif|webp), transparent, notify_url (https), engine (cycles|eevee),
                  environment, environment_strength, environment_visible, blender, orbit, orbit_frames, orbit_elevation}
 GET  /v1/jobs/{id}      status, progress, eta, artifacts[], cost, warnings, info    DELETE /v1/jobs/{id}  cancel
 GET  /v1/jobs/{id}/artifacts/{name}             PNG / MP4
+GET  /v1/assets/search?q=&kind=models|textures|hdris   CC0 assets (Poly Haven) -> spec polyhaven:<id>
+POST /v1/files/{id}/assets/urls {urls: ["https://...", "polyhaven:<id>"]}   fetch assets server-side
 POST /mcp                                       remote MCP (Streamable HTTP; Bearer api key or OAuth)
 GET  /.well-known/oauth-protected-resource/mcp  OAuth discovery
 POST /v1/billing/checkout {amount_yen} -> {checkout_url}   POST /v1/billing/sync   GET /v1/ledger   GET /v1/me

{janction_render-0.4.1 → janction_render-0.4.3}/janction_render/__init__.py

@@ -1,3 +1,3 @@
 """JANCTION Render — ターミナルの AI エージェントから GPU で 3DCG を描く。"""
 
-__version__ = "0.4.1"
+__version__ = "0.4.3"

{janction_render-0.4.1 → janction_render-0.4.3}/janction_render/cli.py

@@ -98,7 +98,8 @@ def cmd_render(c: Client, args: argparse.Namespace) -> int:
     w, h = args.size
     fs, fe = args.frames
     j = c.submit(sid, kind="final", frame_start=fs, frame_end=fe, width=w, height=h,
-                 samples=args.samples, fps=args.fps, output=args.output, camera=args.camera, engine=args.engine)
+                 samples=args.samples, fps=args.fps, output=args.output, camera=args.camera, engine=args.engine,
+                 transparent=args.transparent or None, notify_url=args.notify_url or None)
     print(f"job {j['job_id']} queued: {fe - fs + 1} frames in {j['progress']['chunks_total']} chunks, "
           f"estimate ~{j['estimate']['seconds']}s", file=sys.stderr)
     if not args.wait:
@@ -200,8 +201,10 @@ def build_parser() -> argparse.ArgumentParser:
     s.add_argument("--samples", type=int, default=128)
     s.add_argument("--engine", choices=["cycles", "eevee"], default=None, help="cycles (default) or eevee (cheaper drafts)")
     s.add_argument("--fps", type=int, default=24)
-    s.add_argument("--output", choices=["auto", "png", "exr", "mp4", "webm", "prores"], default="auto",
-                   help="png/exr = frames, mp4/webm/prores = video (auto: mp4 for a range, png for one frame)")
+    s.add_argument("--output", choices=["auto", "png", "exr", "mp4", "webm", "prores", "gif", "webp"], default="auto",
+                   help="png/exr = frames, mp4/webm/prores/gif/webp = video (auto: mp4 for a range, png for one frame)")
+    s.add_argument("--transparent", action="store_true", help="transparent background (png/exr/webm/gif/webp)")
+    s.add_argument("--notify-url", default=None, help="https URL that receives one JSON POST when the job finishes")
     s.add_argument("--camera", default=None)
     s.add_argument("--out", default=None)
     s.add_argument("--wait", action="store_true", help="wait until done and download")

{janction_render-0.4.1 → janction_render-0.4.3}/janction_render/client.py

@@ -361,6 +361,20 @@ class Client:
         self._raise(r)
         return r.json()
 
+    def fetch_asset_urls(self, scene_id: str, urls: list[str]) -> dict[str, Any]:
+        """URL か polyhaven:<id> の素材を受付に取らせてシーンに足す（受付が取るので手元には要らない）。"""
+        r = self.s.post(f"{self.server}/v1/files/{scene_id}/assets/urls", headers=self._headers(),
+                        json={"urls": [str(u) for u in urls]}, timeout=900)
+        self._raise(r)
+        return r.json()
+
+    def asset_search(self, query: str, kind: str = "models") -> dict[str, Any]:
+        """Poly Haven（CC0）の素材を名前・タグで引く。"""
+        r = self.s.get(f"{self.server}/v1/assets/search", headers=self._headers(),
+                       params={"q": query, "kind": kind}, timeout=30)
+        self._raise(r)
+        return r.json()
+
     def upload_text(self, name: str, text: str) -> dict[str, Any]:
         """文字列で受け取った bpy スクリプトを、そのままシーンとして送る（ファイルを作らなくてよい）。"""
         import tempfile

{janction_render-0.4.1 → janction_render-0.4.3}/janction_render/mcp_app.html

@@ -92,6 +92,8 @@ function render() {
   const links = job.links || {};
   if (status === "done" && out && /\.(mp4|webm|mov)(\?|$)/.test(out)) {
     html += `<video controls playsinline src="${esc(out)}"></video>`;
+  } else if (status === "done" && out && /\.(gif|webp)(\?|$)/.test(out)) {
+    html += `<img class="sheet" src="${esc(out)}" alt="animation">`;
   }
   if (status === "done" && isCompare(job)) {
     html += `<div class="muted">Pick the lighting for the final render:</div><div class="grid">` +

{janction_render-0.4.1 → janction_render-0.4.3}/janction_render/mcp_server.py

@@ -52,6 +52,13 @@ mcp = MCPServer(
     ),
 )
 
+OUTPUT_DOC = (" output: 'auto' (mp4 for a frame range, png for one frame) | 'png' | 'exr' (16-bit linear OpenEXR frames) | "
+              "'mp4' (H.264) | 'webm' (VP9) | 'prores' (ProRes 422 HQ .mov) | 'gif' | 'webp' (animated, at most 960 px wide; "
+              "good for chat and web). transparent=True renders on a transparent background (alpha): png / exr frames, webm, gif "
+              "and webp keep it, mp4 and prores cannot. notify_url: an https URL that receives one JSON POST when the job "
+              "finishes (event job.done / job.failed, artifacts with download links).")
+TRANSPARENT_DOC = (" transparent=True: transparent background (alpha) instead of the world/HDRI backdrop; the preview sheet "
+                   "shows it over dark grey.")
 ORBIT_DOC = (" orbit=True: turntable; an orbit camera circles the scene once over orbit_frames frames (default 24, "
              "elevation orbit_elevation deg, default 18). Flat floors/walls are ignored when framing; orbit_target = an "
              "object name or 'x,y,z' centres on that, orbit_distance scales the distance (1.0). A preview without frames "
@@ -80,6 +87,10 @@ ENV_DOC = ("environment: '' keeps the scene's own world; 'studio' | 'sunset' | '
            "blender: '' (5.0) or '5.2' to render with Blender 5.2 when available. assets: local files (images, glTF "
            ".bin, ...) sent along with the scene; a .blend finds them through relative paths, a script through "
            "os.environ['JR_ASSETS_DIR'].")
+POLYHAVEN_DOC = (" assets may also hold 'polyhaven:<id>' (a CC0 model, texture or HDRI from polyhaven.com, fetched by the "
+                 "service into JR_ASSETS_DIR/<id>/; find ids with asset_search) or an https URL. Import a model with "
+                 "bpy.ops.import_scene.gltf(filepath=os.path.join(os.environ['JR_ASSETS_DIR'], '<id>', '<id>_1k.gltf')).")
+ENV_DOC = ENV_DOC + POLYHAVEN_DOC
 
 
 def _log(msg: str) -> None:
@@ -146,8 +157,28 @@ def _payment_block(exc: ClientError) -> Optional[dict[str, Any]]:
 _LAST_UPLOAD: dict[str, Any] = {}
 
 
+def _is_remote_asset(a: str) -> bool:
+    s = str(a).strip().lower()
+    return s.startswith("polyhaven:") or s.startswith("https://")
+
+
 def _resolve_scene(c: Client, scene_path: str, scene_id: str, scene_script: str = "",
                    assets: Optional[list[str]] = None) -> str:
+    """手元のファイルは upload、polyhaven:<id> と https の素材は受付に取らせる。"""
+    remote = [str(a) for a in (assets or []) if _is_remote_asset(a)]
+    local = [a for a in (assets or []) if not _is_remote_asset(a)]
+    sid = _resolve_scene_local(c, scene_path, scene_id, scene_script, local or None)
+    if remote:
+        up = c.fetch_asset_urls(sid, remote)
+        got = list(_LAST_UPLOAD.get("assets") or [])
+        _LAST_UPLOAD["assets"] = got + [x for x in (up.get("added") or []) if x not in got]
+        if up.get("polyhaven"):
+            _LAST_UPLOAD["polyhaven"] = up["polyhaven"]
+    return sid
+
+
+def _resolve_scene_local(c: Client, scene_path: str, scene_id: str, scene_script: str = "",
+                         assets: Optional[list[str]] = None) -> str:
     _LAST_UPLOAD.clear()
     if scene_id:
         if assets:
@@ -241,7 +272,38 @@ def scene_info(scene_path: str = "", scene_id: str = "", scene_script: str = "",
     return _j(_attach_upload_notes(info))
 
 
-@mcp.tool(structured_output=False, meta=_ui_meta())
+RENDER_PREVIEW_DESCRIPTION = (
+    """Render a fast, cheap preview of a Blender scene on a JANCTION GPU and show the image.
+
+    Use this when the user is making 3DCG with Blender and wants to see how it looks, but has no
+    GPU or local rendering is slow. Give the scene as scene_path (a .blend file OR a bpy Python
+    script), scene_script (bpy code as text; no file and no local Blender needed), or scene_id
+    from a previous call. frames: '' = frame 1;
+    '12' = one frame; '1,8,16,24' or '1-24' = up to 4 frames tiled in ONE image (2x2, each tile
+    labeled with its frame number) so you can judge camera motion and animation. Same GPU cost as
+    one 720p frame. Quality is deliberately low (up to 1280x720, few samples, denoised).
+    Look at the returned image, fix the scene, preview again; when it looks right, ask the user and
+    call render_final. Returns scene_id (reuse it without re-uploading), job_id, saved PNG paths,
+    Blender warnings (e.g. missing textures), GPU seconds, and the expiry time (24h after last use).
+    """ + ENV_DOC + ORBIT_DOC + TRANSPARENT_DOC
+)
+
+
+@mcp.tool()
+def asset_search(query: str, kind: str = "models") -> str:
+    """Find CC0 3D models, PBR textures or HDRIs on Poly Haven by words (name, tags, category), to furnish a scene
+    without local files. kind: 'models' (default) | 'textures' | 'hdris'. Each result has spec 'polyhaven:<id>', its
+    size in metres (models) and the entry file. Then pass the spec in assets of scene_info / render_preview /
+    render_final; the service fetches the files into JR_ASSETS_DIR/<id>/ and the scene script imports the entry with
+    bpy.ops.import_scene.gltf(filepath=os.path.join(os.environ['JR_ASSETS_DIR'], '<entry>')). No GPU time is used."""
+    c = _client()
+    try:
+        return _j(c.asset_search(query, kind))
+    except ClientError as exc:
+        return _j({"ok": False, "error": str(exc)})
+
+
+@mcp.tool(structured_output=False, meta=_ui_meta(), description=RENDER_PREVIEW_DESCRIPTION)
 def render_preview(
     scene_path: str = "",
     scene_id: str = "",
@@ -263,26 +325,15 @@ def render_preview(
     orbit_target: str = "",
     orbit_distance: float = 1.0,
     engine: str = "",
+    transparent: bool = False,
 ) -> list[Any]:
-    """Render a fast, cheap preview of a Blender scene on a JANCTION GPU and show the image.
-
-    Use this when the user is making 3DCG with Blender and wants to see how it looks, but has no
-    GPU or local rendering is slow. Give the scene as scene_path (a .blend file OR a bpy Python
-    script), scene_script (bpy code as text; no file and no local Blender needed), or scene_id
-    from a previous call. frames: '' = frame 1;
-    '12' = one frame; '1,8,16,24' or '1-24' = up to 4 frames tiled in ONE image (2x2, each tile
-    labeled with its frame number) so you can judge camera motion and animation. Same GPU cost as
-    one 720p frame. Quality is deliberately low (up to 1280x720, few samples, denoised).
-    Look at the returned image, fix the scene, preview again; when it looks right, ask the user and
-    call render_final. Returns scene_id (reuse it without re-uploading), job_id, saved PNG paths,
-    Blender warnings (e.g. missing textures), GPU seconds, and the expiry time (24h after last use).
-    """ + ENV_DOC + ORBIT_DOC
+    """Render a fast, cheap preview of a Blender scene on a JANCTION GPU and show the image. (full description on the tool)."""
     c = _client()
     try:
         frame_list = parse_frames(frames) if (frames or not orbit) else None
         sid = _resolve_scene(c, scene_path, scene_id, scene_script, assets)
         j = c.submit(sid, kind="preview", frames=frame_list, camera=camera or None,
-                     width=width, height=height, samples=samples,
+                     width=width, height=height, samples=samples, transparent=(True if transparent else None),
                      **_job_params(environment, environment_strength, environment_visible, blender, engine=engine),
                      **({"orbit": True, "orbit_frames": orbit_frames, "orbit_elevation": orbit_elevation,
                          "orbit_target": orbit_target, "orbit_distance": orbit_distance} if orbit else {}))
@@ -343,7 +394,20 @@ def render_estimate(scene_id: str = "", kind: str = "final", frame_start: int =
     return _j(out)
 
 
-@mcp.tool(meta=_ui_meta())
+RENDER_FINAL_DESCRIPTION = (
+    """Render the final frames (or a video) of a Blender scene on JANCTION GPUs.
+
+    Call this after the user approved a preview. Pass scene_id from render_preview (or scene_path /
+    scene_script to upload a new .blend / bpy script / 3D file). frame_start..frame_end are inclusive; several frames are
+    split across GPUs and joined into output.mp4 (output='mp4', fps), a single frame gives a PNG
+    (output='png'; 'auto' picks). Use the same environment / blender as the approved preview. Returns job_id and a
+    time estimate right away; the render runs in the background: poll with render_status, then fetch with
+    render_download. Inputs and results are deleted 24 hours after last use, so download them.
+    """ + ENV_DOC + ORBIT_DOC + OUTPUT_DOC
+)
+
+
+@mcp.tool(meta=_ui_meta(), description=RENDER_FINAL_DESCRIPTION)
 def render_final(
     scene_path: str = "",
     scene_id: str = "",
@@ -367,16 +431,10 @@ def render_final(
     orbit_target: str = "",
     orbit_distance: float = 1.0,
     engine: str = "",
+    transparent: bool = False,
+    notify_url: str = "",
 ) -> str:
-    """Render the final frames (or a video) of a Blender scene on JANCTION GPUs.
-
-    Call this after the user approved a preview. Pass scene_id from render_preview (or scene_path /
-    scene_script to upload a new .blend / bpy script / 3D file). frame_start..frame_end are inclusive; several frames are
-    split across GPUs and joined into output.mp4 (output='mp4', fps), a single frame gives a PNG
-    (output='png'; 'auto' picks). Use the same environment / blender as the approved preview. Returns job_id and a
-    time estimate right away; the render runs in the background: poll with render_status, then fetch with
-    render_download. Inputs and results are deleted 24 hours after last use, so download them.
-    """ + ENV_DOC + ORBIT_DOC
+    """Render the final frames (or a video) of a Blender scene on JANCTION GPUs. (full description on the tool)."""
     c = _client()
     try:
         sid = _resolve_scene(c, scene_path, scene_id, scene_script, assets)
@@ -388,7 +446,7 @@ def render_final(
                 frame_end = None  # type: ignore[assignment]  # 1 周ぶんは受付が決める
         j = c.submit(sid, kind="final", frame_start=frame_start, frame_end=frame_end,
                      width=width, height=height, samples=samples, fps=fps, output=output,
-                     camera=camera or None,
+                     camera=camera or None, transparent=(True if transparent else None), notify_url=notify_url or None,
                      **_job_params(environment, environment_strength, environment_visible, blender, engine=engine), **extra)
     except ClientError as exc:
         block = _payment_block(exc) or _quota_block(exc)

{janction_render-0.4.1 → janction_render-0.4.3}/janction_render.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: janction-render
-Version: 0.4.1
+Version: 0.4.3
 Summary: Cloud GPU render farm for Blender, for AI agents: MCP server (remote + stdio) and CLI. Render Blender without a GPU from Claude, ChatGPT, Claude Code, Codex, Cursor.
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -37,6 +37,9 @@ without a GPU, or when rendering locally is slow.
 - In hosts that support MCP Apps (Claude web and desktop, among others), previews, progress and download links also appear
   as an interactive panel in the chat: the image, a progress bar, "Open MP4", and preset buttons after an `environment="compare"` preview.
   Both the remote connector and the stdio package ship the panel (`janction_render/mcp_app.html`); set `JR_MCP_APPS=0` to turn it off.
+- CC0 assets by name: `asset_search("wooden table")` finds Poly Haven models, textures and HDRIs; pass `polyhaven:<id>` in
+  `asset_urls` (remote) or `assets` (stdio) and the files land in `JR_ASSETS_DIR/<id>/` on the GPU, ready to import
+  (`bpy.ops.import_scene.gltf(filepath=os.path.join(os.environ['JR_ASSETS_DIR'], 'wooden_table_02', 'wooden_table_02_1k.gltf'))`).
 - `scene_info` reads the scene without rendering (cameras, frame range, missing files).
 - `render_preview` returns 1-4 low-cost frames tiled in one image within seconds, so the agent can look, fix, and repeat.
 - `render_estimate` says how long a render will take ("about 3 minutes") and whether it fits today's free quota.
@@ -116,9 +119,10 @@ Then, in Claude Code:
 | `scene_info(scene_script | scene_url | scene_path | scene_id, assets?)` | cameras, frame range, fps, resolution, objects, lights, missing files. No render. |
 | `render_preview(..., frames="1-24", environment?, blender?)` | up to 4 frames (720p budget) tiled with frame labels; returns the image inline |
 | `render_estimate(scene_id, frame_start, frame_end, width, height, samples)` | GPU seconds, queue wait, "about N minutes", fits today's free quota? No GPU time used |
-| `render_final(scene_id, frame_start, frame_end, width, height, samples, fps, output, environment?, blender?, engine?)` | frames (png / exr) or video (mp4 / webm / prores); returns job_id + estimate |
+| `render_final(scene_id, frame_start, frame_end, width, height, samples, fps, output, environment?, blender?, engine?, transparent?, notify_url?)` | frames (png / exr) or video (mp4 / webm / prores / gif / webp); `transparent=True` keeps an alpha background (png / exr / webm / gif / webp); `notify_url` gets one JSON POST when the job finishes; returns job_id + estimate |
 | `render_status(job_id)` | progress and ETA (`eta.human`); `render_download(job_id, only="mp4" / "frames" / "all")` files or links; `render_cancel(job_id)` |
 | `billing()` | free-beta quota (used today, daily limit, reset time); later balance and top-up link |
+| `asset_search(query, kind)` | CC0 models / textures / HDRIs on Poly Haven by words; results carry `polyhaven:<id>` and the entry file |
 | `render_info()` | workers online or gated (GPU lent to another workload), queue, expected wait, supported inputs, environment presets, Blender versions |
 
 Options on `render_preview` / `render_final`: `environment` (`studio`, `sunset`, `overcast`, `night`, `compare` on previews; `environment_strength`,
@@ -155,10 +159,12 @@ POST /v1/keys                                   -> {api_key}         (header X-A
 POST /v1/files  multipart "file" (.blend|.py|.glb|.fbx|.usd|.obj|...)   -> {scene_id}
 POST /v1/files/{id}/assets  multipart "files"   textures, glTF .bin ...   GET /v1/files/lookup?sha256=  reuse an upload
 POST /v1/estimate {kind, frames|frame_start/frame_end, width, height, samples, scene_id?} -> seconds, wall_seconds, human, quota
-POST /v1/jobs   {scene_id, kind: info|preview|final, frames|frame_start/frame_end, width, height, samples, camera, fps, output (png|exr|mp4|webm|prores), engine (cycles|eevee),
+POST /v1/jobs   {scene_id, kind: info|preview|final, frames|frame_start/frame_end, width, height, samples, camera, fps, output (png|exr|mp4|webm|prores|gif|webp), transparent, notify_url (https), engine (cycles|eevee),
                  environment, environment_strength, environment_visible, blender, orbit, orbit_frames, orbit_elevation}
 GET  /v1/jobs/{id}      status, progress, eta, artifacts[], cost, warnings, info    DELETE /v1/jobs/{id}  cancel
 GET  /v1/jobs/{id}/artifacts/{name}             PNG / MP4
+GET  /v1/assets/search?q=&kind=models|textures|hdris   CC0 assets (Poly Haven) -> spec polyhaven:<id>
+POST /v1/files/{id}/assets/urls {urls: ["https://...", "polyhaven:<id>"]}   fetch assets server-side
 POST /mcp                                       remote MCP (Streamable HTTP; Bearer api key or OAuth)
 GET  /.well-known/oauth-protected-resource/mcp  OAuth discovery
 POST /v1/billing/checkout {amount_yen} -> {checkout_url}   POST /v1/billing/sync   GET /v1/ledger   GET /v1/me

{janction_render-0.4.1 → janction_render-0.4.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "janction-render"
-version = "0.4.1"
+version = "0.4.3"
 description = "Cloud GPU render farm for Blender, for AI agents: MCP server (remote + stdio) and CLI. Render Blender without a GPU from Claude, ChatGPT, Claude Code, Codex, Cursor."
 readme = "README.md"
 requires-python = ">=3.11"