Upload 5 files

CHANGELOG.md

@@ -19,3 +19,10 @@
 
 - Confirmed Gradio Client auth compatibility helper.
 - Improved stdout logging for worker events.
+
+## v4 — Pi gist recipe
+
+- Added Phase 4 tab: Pi reads the HF Spaces Agent Quickstart gist and is asked to use the `hf` CLI to create/upload a private target Space.
+- Added a new `pi_gist_recipe` worker payload.
+- The wrapper still performs independent final validation through the live Gradio API before declaring success.
+- Saved artifacts include `generated/GOAL.md`, optional `generated/PI_SUMMARY.md`, Pi logs, traces, API schema, and API test result.

README.md

@@ -18,7 +18,7 @@ hf_oauth_scopes:
   - jobs
 ---
 
-# Agentic Space Factory — V3 Pi Smoke
+# Agentic Space Factory — V4 Pi Gist Recipe
 
 This version validates the safe foundation for a Hugging Face-native “Agentic Space Factory”.
 
@@ -115,6 +115,7 @@ For local UI development, the app can render, but launching a Job requires a rea
 
 
 ## Phase 3 — Pi smoke test
+- Phase 4 — Pi gist recipe
 
 This phase installs `@mariozechner/pi-coding-agent` inside the HF Job, configures Pi with Hugging Face Inference Providers using the OAuth token, and asks Pi to make one safe edit to a generated Gradio app before creating the private target Space.
 
@@ -129,3 +130,8 @@ runs/<run_id>/tests/test_result.json
 ```
 
 The target Space remains private by default. Success is only declared after the live Gradio API returns the expected Pi-modified output.
+
+
+## Phase 4
+
+Phase 4 asks Pi to follow the HF Spaces Agent Quickstart gist and use the `hf` CLI inside an HF Job to create/upload a private Space. The wrapper independently validates the live Gradio API before reporting success.

app.py

@@ -12,6 +12,7 @@ from src.jobs import (
     inspect_job_safe,
     launch_create_private_space_job,
     launch_hello_job,
+    launch_pi_gist_recipe_job,
     launch_pi_space_smoke_job,
 )
 from src.runs import make_run_id, validate_run_id
@@ -19,7 +20,7 @@ from src.security import redact
 
 
 APP_DESCRIPTION = f"""
-# Agentic Space Factory — V3 Pi Smoke
+# Agentic Space Factory — V4 Pi Gist Recipe
 
 This version validates the two critical foundations:
 
@@ -27,6 +28,7 @@ This version validates the two critical foundations:
 Phase 1: HF OAuth → HF Job → mounted private Bucket → run state/events/report → UI readback
 Phase 2: HF OAuth → HF Job → private target Space → file upload → live Gradio API validation → Bucket report
 Phase 3: HF OAuth → HF Job → Pi modifies app.py → private target Space → live API validation → Pi traces
+Phase 4: HF OAuth → HF Job → Pi reads gist → uses hf CLI → private Space → wrapper live API validation
 ```
 
 Configured bucket: `{settings.bucket_uri}`
@@ -69,6 +71,38 @@ def propose_pi_run_id() -> str:
     return make_run_id("pi")
 
 
+def propose_gist_run_id() -> str:
+    return make_run_id("gist")
+
+
+def launch_pi_gist_job_ui(
+    requested_run_id: str,
+    target_space_name: str,
+    pi_model: str,
+    profile: gr.OAuthProfile | None,
+    oauth_token: gr.OAuthToken | None,
+) -> tuple[str, str, str, str, str, str]:
+    username = _profile_username(profile)
+    token = _token_value(oauth_token)
+    if not username or not token:
+        raise gr.Error("Please sign in with Hugging Face first. OAuth profile/token is missing.")
+
+    run_id = validate_run_id(requested_run_id or propose_gist_run_id())
+    result = launch_pi_gist_recipe_job(
+        token=token,
+        username=username,
+        target_slug=target_space_name,
+        pi_model=pi_model,
+        run_id=run_id,
+    )
+
+    job_url = result.get("job_url") or ""
+    target_space = result.get("target_space") or ""
+    target_url = result.get("target_space_url") or ""
+    summary = json.dumps(result, indent=2)
+    return run_id, result["job_id"], job_url, target_space, target_url, summary
+
+
 def launch_pi_space_job_ui(
     requested_run_id: str,
     target_space_name: str,
@@ -173,6 +207,68 @@ def build_demo() -> gr.Blocks:
         login_status = gr.Markdown()
         demo.load(fn=get_login_status, inputs=None, outputs=login_status)
 
+        with gr.Tab("Phase 4 — Pi gist recipe"): 
+            gr.Markdown(
+                """
+This phase is the first closer reproduction of the article workflow. The HF Job installs Pi, gives it the HF Spaces Agent Quickstart gist, and asks Pi to use the `hf` CLI to create/upload a **private** target Space.
+
+The wrapper still stays in control of final success: it independently checks that the target Space exists and validates the live Gradio API.
+
+Use a fresh Space name. This phase intentionally fails if the target Space already exists.
+"""
+            )
+            with gr.Row():
+                gist_run_id_box = gr.Textbox(label="Run ID", value=propose_gist_run_id, interactive=True)
+                new_gist_run_btn = gr.Button("Generate new run id")
+            new_gist_run_btn.click(fn=propose_gist_run_id, inputs=None, outputs=gist_run_id_box)
+
+            gist_target_space_name = gr.Textbox(
+                label="Target Space name",
+                placeholder="e.g. space-factory-pi-gist-v1",
+                info="Use a new name. Pi is asked to create this private Space under your username using hf CLI.",
+            )
+            gist_model_box = gr.Textbox(
+                label="Pi model",
+                value="moonshotai/Kimi-K2.5",
+                info="Model used by Pi through Hugging Face Inference Providers.",
+            )
+            launch_gist_btn = gr.Button("Run Pi gist recipe", variant="primary")
+
+            phase4_job_id_box = gr.Textbox(label="Job ID", interactive=True)
+            phase4_job_url_box = gr.Textbox(label="Job URL", interactive=False)
+            phase4_target_space_box = gr.Textbox(label="Target Space", interactive=False)
+            phase4_target_url_box = gr.Textbox(label="Target Space URL", interactive=False)
+            phase4_launch_result = gr.Code(label="Launch result", language="json")
+
+            launch_gist_btn.click(
+                fn=launch_pi_gist_job_ui,
+                inputs=[gist_run_id_box, gist_target_space_name, gist_model_box],
+                outputs=[
+                    gist_run_id_box,
+                    phase4_job_id_box,
+                    phase4_job_url_box,
+                    phase4_target_space_box,
+                    phase4_target_url_box,
+                    phase4_launch_result,
+                ],
+            )
+
+            phase4_refresh_btn = gr.Button("Refresh Phase 4 run status")
+            with gr.Tab("Phase 4 state"):
+                phase4_state_code = gr.Code(label="state.json", language="json")
+            with gr.Tab("Phase 4 events"):
+                phase4_events_code = gr.Code(label="events.jsonl", language="json")
+            with gr.Tab("Phase 4 report"):
+                phase4_report_md = gr.Markdown()
+            with gr.Tab("Phase 4 job"):
+                phase4_job_code = gr.Code(label="Job status/logs", language="json")
+
+            phase4_refresh_btn.click(
+                fn=refresh_run_ui,
+                inputs=[gist_run_id_box, phase4_job_id_box],
+                outputs=[phase4_state_code, phase4_events_code, phase4_report_md, phase4_job_code],
+            )
+
 
         with gr.Tab("Phase 3 — Pi smoke test"):
             gr.Markdown(
@@ -328,12 +424,12 @@ It will fail safely if the target Space already exists, to avoid overwriting use
             """
 ## Next increments
 
-After Phase 2 passes, the next step is Phase 3:
+After Phase 4 passes, the next step is Phase 5:
 
-1. install and configure Pi inside the Job,
-2. ask Pi to modify/repair the simple target Space,
-3. collect Pi traces into the bucket,
-4. keep the same live API validation gate.
+1. analyze a real model card,
+2. choose a small template,
+3. let Pi apply the same gist-style loop,
+4. keep the wrapper-owned live API validation gate.
 """
         )