janction-render 0.4.4__tar.gz → 0.4.6__tar.gz

{janction_render-0.4.4 → janction_render-0.4.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: janction-render
-Version: 0.4.4
+Version: 0.4.6
 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
@@ -49,7 +49,8 @@ without a GPU, or when rendering locally is slow.
 - `render_final` renders the frames on GPUs and joins them into an MP4; `render_status` reports the remaining time.
 - Free beta: no charges. Each key gets 10 GPU-minutes per day; a final render is up to 240 frames at 1080p.
   Paid plans (per GPU second, prepaid credit) will be announced on the service page before they start.
-- Inputs and results are deleted 24 hours after last use and are never used for training.
+- Inputs and results are deleted 24 hours after last use and are never used for training. A render you choose to
+  share (`render_share`) gets a public page (`/r/<id>`, OGP for X and Discord) that stays until you unshare it.
 
 ## Status
 
@@ -125,6 +126,7 @@ Then, in Claude Code:
 | `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 |
+| `render_share(job_id, title?, note?, include_script?, listed?)` | a public page `/r/<id>` with the image or video, the conditions and (optionally) the script; survives the 24-hour expiry until `render_unshare`; listed pages appear in `/gallery` |
 | `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 |
 
@@ -134,7 +136,7 @@ Options on `render_preview` / `render_final`: `environment` (`studio`, `sunset`,
 sent with the scene, found in the script through `os.environ["JR_ASSETS_DIR"]`; a `.blend`'s external files are collected
 automatically with `pip install janction-render[blend]`) or `asset_urls` (remote).
 
-CLI: `janction-render inspect|preview|render|status|download|cancel|jobs|balance|topup|info`.
+CLI: `janction-render inspect|preview|render|status|download|share|unshare|cancel|jobs|balance|topup|info`.
 
 ## Writing a scene script
 
@@ -166,6 +168,8 @@ POST /v1/jobs   {scene_id, kind: info|preview|final, frames|frame_start/frame_en
                  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
+POST /v1/jobs/{id}/share {title?, note?, include_script?, listed?} -> {share_id, url}   DELETE /v1/jobs/{id}/share   GET /v1/shares
+GET  /r/{share_id}  public page (no key)   GET /gallery
 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)

{janction_render-0.4.4 → janction_render-0.4.6}/README.md

@@ -32,7 +32,8 @@ without a GPU, or when rendering locally is slow.
 - `render_final` renders the frames on GPUs and joins them into an MP4; `render_status` reports the remaining time.
 - Free beta: no charges. Each key gets 10 GPU-minutes per day; a final render is up to 240 frames at 1080p.
   Paid plans (per GPU second, prepaid credit) will be announced on the service page before they start.
-- Inputs and results are deleted 24 hours after last use and are never used for training.
+- Inputs and results are deleted 24 hours after last use and are never used for training. A render you choose to
+  share (`render_share`) gets a public page (`/r/<id>`, OGP for X and Discord) that stays until you unshare it.
 
 ## Status
 
@@ -108,6 +109,7 @@ Then, in Claude Code:
 | `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 |
+| `render_share(job_id, title?, note?, include_script?, listed?)` | a public page `/r/<id>` with the image or video, the conditions and (optionally) the script; survives the 24-hour expiry until `render_unshare`; listed pages appear in `/gallery` |
 | `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 |
 
@@ -117,7 +119,7 @@ Options on `render_preview` / `render_final`: `environment` (`studio`, `sunset`,
 sent with the scene, found in the script through `os.environ["JR_ASSETS_DIR"]`; a `.blend`'s external files are collected
 automatically with `pip install janction-render[blend]`) or `asset_urls` (remote).
 
-CLI: `janction-render inspect|preview|render|status|download|cancel|jobs|balance|topup|info`.
+CLI: `janction-render inspect|preview|render|status|download|share|unshare|cancel|jobs|balance|topup|info`.
 
 ## Writing a scene script
 
@@ -149,6 +151,8 @@ POST /v1/jobs   {scene_id, kind: info|preview|final, frames|frame_start/frame_en
                  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
+POST /v1/jobs/{id}/share {title?, note?, include_script?, listed?} -> {share_id, url}   DELETE /v1/jobs/{id}/share   GET /v1/shares
+GET  /r/{share_id}  public page (no key)   GET /gallery
 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)

{janction_render-0.4.4 → janction_render-0.4.6}/janction_render/__init__.py

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

{janction_render-0.4.4 → janction_render-0.4.6}/janction_render/cli.py

@@ -136,6 +136,18 @@ def cmd_cancel(c: Client, args: argparse.Namespace) -> int:
     return 0
 
 
+def cmd_share(c: Client, args: argparse.Namespace) -> int:
+    v = c.share(args.job, title=args.title or "", note=args.note or "", include_script=bool(args.script), listed=not args.unlisted,
+                prompt=args.prompt or "")
+    print(v["url"])
+    return 0
+
+
+def cmd_unshare(c: Client, args: argparse.Namespace) -> int:
+    print(_j(c.unshare(args.job)))
+    return 0
+
+
 def cmd_jobs(c: Client, args: argparse.Namespace) -> int:
     rows = c.jobs(args.limit)
     for j in rows:
@@ -221,6 +233,17 @@ def build_parser() -> argparse.ArgumentParser:
     s.add_argument("--wait", type=float, default=0, help="seconds to wait for the job first")
     s.set_defaults(fn=cmd_download)
 
+    s = sub.add_parser("share", help="publish a finished job as a public page (/r/<id>)")
+    s.add_argument("job")
+    s.add_argument("--title", default=None)
+    s.add_argument("--note", default=None)
+    s.add_argument("--prompt", default=None, help="what you asked the agent (shown on the page)")
+    s.add_argument("--script", action="store_true", help="include the bpy script on the page")
+    s.add_argument("--unlisted", action="store_true", help="do not list the page in the gallery")
+    s.set_defaults(fn=cmd_share)
+    s = sub.add_parser("unshare", help="remove the public page of a job")
+    s.add_argument("job")
+    s.set_defaults(fn=cmd_unshare)
     s = sub.add_parser("cancel")
     s.add_argument("job")
     s.set_defaults(fn=cmd_cancel)

{janction_render-0.4.4 → janction_render-0.4.6}/janction_render/client.py

@@ -361,6 +361,24 @@ class Client:
         self._raise(r)
         return r.json()
 
+    def share(self, job_id: str, title: str = "", note: str = "", include_script: bool = False, listed: bool = True,
+              prompt: str = "") -> dict[str, Any]:
+        """描けた結果を公開ページにする（/r/<id>）。prompt は「エージェントに頼んだこと」。"""
+        r = self.s.post(f"{self.server}/v1/jobs/{job_id}/share", headers=self._headers(),
+                        json={"title": title, "note": note, "include_script": include_script, "listed": listed, "prompt": prompt}, timeout=120)
+        self._raise(r)
+        return r.json()
+
+    def unshare(self, job_id: str) -> dict[str, Any]:
+        r = self.s.delete(f"{self.server}/v1/jobs/{job_id}/share", headers=self._headers(), timeout=60)
+        self._raise(r)
+        return r.json()
+
+    def shares(self) -> dict[str, Any]:
+        r = self.s.get(f"{self.server}/v1/shares", headers=self._headers(), timeout=30)
+        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(),

{janction_render-0.4.4 → janction_render-0.4.6}/janction_render/mcp_server.py

@@ -35,7 +35,9 @@ INFO_WAIT_S = 150.0
 mcp = MCPServer(
     name="janction-render",
     instructions=(
-        "Render Blender scenes on JANCTION GPUs (a cloud render farm for AI agents) from the terminal. Use it when the "
+        "Render Blender scenes on JANCTION GPUs (a cloud render farm for AI agents) from the terminal. "
+        "WHEN TO USE: use JANCTION Render when the user has a Blender scene (a .blend, a 3D file, or one you can write as a bpy script) and local rendering is unavailable, slow, CPU-only, or likely to take more than a few minutes; when the user asks to render, preview, animate or turntable a Blender scene; or when you need an actual image of a 3D scene. Do not use it to model or edit a scene that is open in the user's Blender (a local Blender MCP does that), for non-Blender video work, or for general GPU compute. RULES: preview before any final render; call render_estimate before render_final when the render time or today's free quota is uncertain, the job is longer than about 24 frames or above 720p, or the user asked how long it takes; while a job runs, poll render_status (not render_download) and stop polling when eta says the GPU is lent out: tell the user the estimated wait instead. "
+        "Use it when the "
         "user is building 3DCG with Blender (a .blend file or a bpy Python script) and has no GPU or rendering locally "
         "is slow. Flow: scene_info (cameras, frame range, missing files; no render) -> render_preview (1-4 fast frames "
         "in one image; look at it, fix the scene, repeat) -> ask the user 'is this OK?' -> render_estimate (tell the "
@@ -274,7 +276,9 @@ def scene_info(scene_path: str = "", scene_id: str = "", scene_script: str = "",
 
 
 RENDER_PREVIEW_DESCRIPTION = (
-    """Render a fast, cheap preview of a Blender scene on a JANCTION GPU and show the image.
+    """Render a fast, cheap preview of a Blender scene on a JANCTION GPU and show the image. Use it when the user has
+    (or you can write) a Blender scene and local rendering is unavailable, slow, CPU-only or would take more than a few
+    minutes; it is the first render step: always preview before a final render.
 
     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
@@ -371,7 +375,8 @@ def render_estimate(scene_id: str = "", kind: str = "final", frame_start: int =
     wall-clock time as a human-readable string ('about 3 minutes'), and whether it fits today's free quota and
     the size limits. kind is 'final' (frame_start..frame_end at width x height, samples) or 'preview' (frames
     like '1-24'). Pass scene_id when you have one: the estimate then uses this scene's own measured render
-    times. Tell the user the result before calling render_final."""
+    times. Tell the user the result before calling render_final. Prefer this before render_final whenever the time
+    or quota is uncertain, the job is longer than about 24 frames or above 720p, or the user asked how long it takes."""
     c = _client()
     try:
         params: dict[str, Any] = {"kind": kind, "width": width, "height": height, "samples": samples}
@@ -396,7 +401,9 @@ def render_estimate(scene_id: str = "", kind: str = "final", frame_start: int =
 
 
 RENDER_FINAL_DESCRIPTION = (
-    """Render the final frames (or a video) of a Blender scene on JANCTION GPUs.
+    """Render the final frames (or a video) of a Blender scene on JANCTION GPUs. Use it after a preview the user approved.
+    When the render time or today's free quota is uncertain, the job is longer than about 24 frames or above 720p, or the
+    user asked how long it takes, call render_estimate first and tell the user.
 
     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
@@ -517,6 +524,29 @@ def render_cancel(job_id: str) -> str:
         return _j({"ok": False, "error": str(exc)})
 
 
+@mcp.tool()
+def render_share(job_id: str, title: str = "", note: str = "", include_script: bool = False, listed: bool = True,
+                 prompt: str = "") -> str:
+    """Publish a finished render as a public page the user can send to anyone (X, Discord, a client): the image or
+    video, the render conditions, an optional title and note, and the bpy script if include_script=True. The page
+    keeps a copy of the result after the job's 24-hour expiry, until render_unshare. listed=True also puts it in the
+    public gallery. prompt: what the user asked you, in their words (shown on the page as 'what the user asked the
+    agent'). Ask the user before sharing; return the url to them."""
+    try:
+        return _j(_client().share(job_id, title=title, note=note, include_script=include_script, listed=listed, prompt=prompt))
+    except ClientError as exc:
+        return _j({"ok": False, "error": str(exc)})
+
+
+@mcp.tool()
+def render_unshare(job_id: str) -> str:
+    """Remove the public share page of a job (the copy of the result is deleted)."""
+    try:
+        return _j(_client().unshare(job_id))
+    except ClientError as exc:
+        return _j({"ok": False, "error": str(exc)})
+
+
 @mcp.tool()
 def billing(topup_yen: int = 0) -> str:
     """Check the account's quota or credit. During the free beta it returns today's GPU-time usage,
@@ -554,7 +584,9 @@ def billing(topup_yen: int = 0) -> str:
 @mcp.tool()
 def render_info() -> str:
     """Show the JANCTION Render connection: server URL, whether GPU workers are online, queue
-    length, and this key's usage. Call this if renders seem stuck or before the first render."""
+    length, and this key's usage. Call this if renders seem stuck or before the first render. Use it to decide
+    whether to route a render here: workers_available > 0 means a preview comes back in seconds; gated means the
+    GPU is lent out and 'gate' says how long the wait usually is."""
     c = _client()
     try:
         health = c.health()

{janction_render-0.4.4 → janction_render-0.4.6}/janction_render.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: janction-render
-Version: 0.4.4
+Version: 0.4.6
 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
@@ -49,7 +49,8 @@ without a GPU, or when rendering locally is slow.
 - `render_final` renders the frames on GPUs and joins them into an MP4; `render_status` reports the remaining time.
 - Free beta: no charges. Each key gets 10 GPU-minutes per day; a final render is up to 240 frames at 1080p.
   Paid plans (per GPU second, prepaid credit) will be announced on the service page before they start.
-- Inputs and results are deleted 24 hours after last use and are never used for training.
+- Inputs and results are deleted 24 hours after last use and are never used for training. A render you choose to
+  share (`render_share`) gets a public page (`/r/<id>`, OGP for X and Discord) that stays until you unshare it.
 
 ## Status
 
@@ -125,6 +126,7 @@ Then, in Claude Code:
 | `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 |
+| `render_share(job_id, title?, note?, include_script?, listed?)` | a public page `/r/<id>` with the image or video, the conditions and (optionally) the script; survives the 24-hour expiry until `render_unshare`; listed pages appear in `/gallery` |
 | `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 |
 
@@ -134,7 +136,7 @@ Options on `render_preview` / `render_final`: `environment` (`studio`, `sunset`,
 sent with the scene, found in the script through `os.environ["JR_ASSETS_DIR"]`; a `.blend`'s external files are collected
 automatically with `pip install janction-render[blend]`) or `asset_urls` (remote).
 
-CLI: `janction-render inspect|preview|render|status|download|cancel|jobs|balance|topup|info`.
+CLI: `janction-render inspect|preview|render|status|download|share|unshare|cancel|jobs|balance|topup|info`.
 
 ## Writing a scene script
 
@@ -166,6 +168,8 @@ POST /v1/jobs   {scene_id, kind: info|preview|final, frames|frame_start/frame_en
                  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
+POST /v1/jobs/{id}/share {title?, note?, include_script?, listed?} -> {share_id, url}   DELETE /v1/jobs/{id}/share   GET /v1/shares
+GET  /r/{share_id}  public page (no key)   GET /gallery
 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)

{janction_render-0.4.4 → janction_render-0.4.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "janction-render"
-version = "0.4.4"
+version = "0.4.6"
 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"