mainsequence 3.19.3__tar.gz → 3.19.5__tar.gz

{mainsequence-3.19.3 → mainsequence-3.19.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mainsequence
-Version: 3.19.3
+Version: 3.19.5
 Summary: Main Sequence SDK 
 Author-email: Main Sequence GmbH <dev@main-sequence.io>
 License: MainSequence GmbH SDK License Agreement
@@ -154,6 +154,7 @@ Recommended entry points:
   - [Working With Simple Tables](docs/tutorial/working_with_simple_tables.md)
   - [Create Your First API](docs/tutorial/create_your_first_api.md)
   - [Role-Based Access Control](docs/tutorial/role_based_access_control.md)
+  - [Turn Your Project Into an Agent](docs/tutorial/project_to_agent.md)
 - Knowledge:
   - [Data Nodes](docs/knowledge/data_nodes.md)
   - [Command Center](docs/knowledge/command_center/index.md)
@@ -209,6 +210,7 @@ From there, the normal learning path is:
 4. understand sharing and RBAC
 5. schedule jobs
 6. build dashboards or downstream consumers
+7. package the project as an agent-facing surface when the repository is ready
 
 ## Installation for development
 

{mainsequence-3.19.3 → mainsequence-3.19.5}/README.md

@@ -64,6 +64,7 @@ Recommended entry points:
   - [Working With Simple Tables](docs/tutorial/working_with_simple_tables.md)
   - [Create Your First API](docs/tutorial/create_your_first_api.md)
   - [Role-Based Access Control](docs/tutorial/role_based_access_control.md)
+  - [Turn Your Project Into an Agent](docs/tutorial/project_to_agent.md)
 - Knowledge:
   - [Data Nodes](docs/knowledge/data_nodes.md)
   - [Command Center](docs/knowledge/command_center/index.md)
@@ -119,6 +120,7 @@ From there, the normal learning path is:
 4. understand sharing and RBAC
 5. schedule jobs
 6. build dashboards or downstream consumers
+7. package the project as an agent-facing surface when the repository is ready
 
 ## Installation for development
 

{mainsequence-3.19.3 → mainsequence-3.19.5}/agent_scaffold/AGENTS.md

@@ -18,9 +18,9 @@ uses them to update only the Main Sequence section below.
 ## Main Sequence Instructions
 
 Before any non-trivial Main Sequence work, verify that this Main Sequence section matches the
-latest installed `agent_scaffold/AGENTS.md` template and that
+latest installed `AGENTS.md` template and that
 `.agents/skills/mainsequence/project_builder/SKILL.md` matches the latest installed
-`agent_scaffold/skills/project_builder/SKILL.md`; if either local file does not match, update it
+`.agents/skills/project_builder/SKILL.md`; if either local file does not match, update it
 before proceeding.
 
 Canonical Main Sequence documentation root:

{mainsequence-3.19.3 → mainsequence-3.19.5}/agent_scaffold/skills/command_center/workspace_builder/SKILL.md

@@ -69,25 +69,32 @@ This skill must not claim ownership of:
 
 0. If widget selection, layout narrative, or visualization strategy is not already decided, use:
    - `.agents/skills/mainsequence/command_center/workspace_design/SKILL.md`
-1. Verify the widget catalog through the CLI:
+1. If the workspace may use connection-backed source widgets, inspect the available connections through the CLI first:
+   - `mainsequence cc connection list --json`
+   - identify the target connection instance `uid`
+   - `mainsequence cc connection detail <CONNECTION_UID> --json`
+   - `mainsequence cc connection_type list --json`
+   - identify the target connection `type_id`
+   - `mainsequence cc connection_type detail <TYPE_ID> --json`
+2. Verify the widget catalog through the CLI:
    - `mainsequence cc registered_widget_type list --json`
    - identify the target `widget_id`
    - `mainsequence cc registered_widget_type detail <WIDGET_ID> --json`
-2. The SDK client models in `mainsequence/client/command_center/`:
+3. The SDK client models in `mainsequence/client/command_center/`:
    - `workspace.py`
    - `connections.py` when source widgets depend on backend-owned connections
    - `data_models.py`
    - `app_component.py` when the workspace contains AppComponent widgets or editable form payloads
-3. `docs/knowledge/command_center/workspaces.md`
-4. the local Main Sequence docs/models/examples in this repository that define the widget payloads being mounted
-5. the current CLI docs if the task uses CLI workflow
+4. `docs/knowledge/command_center/workspaces.md`
+5. the local Main Sequence docs/models/examples in this repository that define the widget payloads being mounted
+6. the current CLI docs if the task uses CLI workflow
 
 If the workspace contains AppComponent widgets, also read:
 
-6. `docs/knowledge/command_center/forms.md`
-7. `docs/knowledge/command_center/widget_data_contracts.md`
-8. `.agents/skills/mainsequence/platform_operations/orchestration_and_releases/SKILL.md` when mounted widgets depend on project APIs that must be usable from Command Center
-9. `.agents/skills/mainsequence/command_center/api_mock_prototyping/SKILL.md` when the workspace should validate an AppComponent/API contract in `mock-json` mode before deployment
+7. `docs/knowledge/command_center/forms.md`
+8. `docs/knowledge/command_center/widget_data_contracts.md`
+9. `.agents/skills/mainsequence/platform_operations/orchestration_and_releases/SKILL.md` when mounted widgets depend on project APIs that must be usable from Command Center
+10. `.agents/skills/mainsequence/command_center/api_mock_prototyping/SKILL.md` when the workspace should validate an AppComponent/API contract in `mock-json` mode before deployment
 
 ## Command Center Mental Model
 

{mainsequence-3.19.3 → mainsequence-3.19.5}/mainsequence/cli/api.py

@@ -18,6 +18,7 @@ import importlib
 import json
 import os
 import re
+import shlex
 from typing import Any
 from urllib.parse import urlencode
 
@@ -4679,6 +4680,30 @@ def schedule_batch_project_jobs(
                 os.environ[k] = v
 
 
+def get_project_job(
+    job_id: int | str,
+    *,
+    timeout: int | None = None,
+) -> dict[str, Any]:
+    """
+    Retrieve one project job via SDK client model.
+    """
+    try:
+        job = _run_sdk_model_operation(
+            module_name="mainsequence.client.models_helpers",
+            class_name="Job",
+            operation=lambda ClientJob: ClientJob.get(pk=int(job_id), timeout=timeout),
+        )
+        return _sdk_object_to_dict(job)
+    except Exception as e:
+        err_name = type(e).__name__
+        if err_name == "NotFoundError":
+            raise ApiError(f"Job not found: {job_id}") from e
+        if isinstance(e, (ApiError, NotLoggedIn)):
+            raise
+        raise ApiError(f"Project job fetch failed: {e}") from e
+
+
 def run_project_job(
     job_id: int | str,
     *,
@@ -4738,11 +4763,35 @@ def run_project_job(
 
         job = ClientJob.get(pk=int(job_id), timeout=timeout)
         payload = job.run_job(timeout=timeout, command_args=command_args)
+        effective_tokens: list[str] = []
+        execution_path = str(getattr(job, "execution_path", "") or "").strip()
+        app_name = str(getattr(job, "app_name", "") or "").strip()
+        if execution_path:
+            effective_tokens.append(execution_path)
+        elif app_name:
+            effective_tokens.append(f"app:{app_name}")
+        if command_args:
+            effective_tokens.extend(str(arg) for arg in command_args)
+        effective_run = shlex.join(effective_tokens) if effective_tokens else None
         if isinstance(payload, dict):
+            if effective_run:
+                payload.setdefault("effective_run", effective_run)
+            if command_args is not None:
+                payload.setdefault("command_args", list(command_args))
             return payload
         if hasattr(payload, "model_dump"):
-            return payload.model_dump()
-        return {"job_id": int(job_id)}
+            payload = payload.model_dump()
+            if effective_run:
+                payload.setdefault("effective_run", effective_run)
+            if command_args is not None:
+                payload.setdefault("command_args", list(command_args))
+            return payload
+        out = {"job_id": int(job_id)}
+        if effective_run:
+            out["effective_run"] = effective_run
+        if command_args is not None:
+            out["command_args"] = list(command_args)
+        return out
 
     except Exception as e:
         err_name = type(e).__name__

{mainsequence-3.19.3 → mainsequence-3.19.5}/mainsequence/cli/cli.py

@@ -31,6 +31,7 @@ import os
 import pathlib
 import platform
 import re
+import shlex
 import shutil
 import subprocess
 import sys
@@ -114,6 +115,7 @@ from .api import (
     get_project,
     get_project_data_node_updates,
     get_project_image,
+    get_project_job,
     get_project_job_run_logs,
     get_projects,
     get_registered_widget_type,
@@ -8834,42 +8836,6 @@ def project_project_resource_create_dashboard_cmd(
     )
 
 
-@project_project_resource_group.command("create_agent")
-def project_project_resource_create_agent_cmd(
-    project_id: int | None = typer.Argument(None, help="Project ID. Defaults to local .env when omitted."),
-    resource_id: int | None = typer.Option(None, "--resource-id", help="Project resource ID."),
-    path: str | None = typer.Option(None, "--path", help="Project repository path (default: current project)"),
-    related_image_id: int | None = typer.Option(None, "--related-image-id", help="Project image ID."),
-    readme_resource_id: int | None = typer.Option(None, "--readme-resource-id", help="Optional README resource ID."),
-    cpu_request: str | None = typer.Option(None, "--cpu-request", help="CPU request (accepts 0.5 or 500m; default: 0.25)."),
-    memory_request: str | None = typer.Option(None, "--memory-request", help="Memory request (accepts 1 or 1Gi; default: 0.5)."),
-    gpu_request: str | None = typer.Option(None, "--gpu-request", help="GPU request count."),
-    gpu_type: str | None = typer.Option(None, "--gpu-type", help="GPU accelerator type."),
-    spot: bool | None = typer.Option(None, "--spot/--no-spot", help="Whether to prefer spot capacity."),
-    timeout: int | None = typer.Option(None, "--timeout", help="Request timeout in seconds"),
-):
-    """
-    Create an agent release from a project resource.
-
-    The command first lets the user select a project image and then filters resources so
-    only resources with `repo_commit_sha == related_image.project_repo_hash` are eligible.
-    """
-    _project_resource_release_create_impl(
-        release_kind="agent",
-        project_id=project_id,
-        resource_id=resource_id,
-        path=path,
-        related_image_id=related_image_id,
-        readme_resource_id=readme_resource_id,
-        cpu_request=cpu_request,
-        memory_request=memory_request,
-        gpu_request=gpu_request,
-        gpu_type=gpu_type,
-        spot=spot,
-        timeout=timeout,
-    )
-
-
 @project_project_resource_group.command("create_fastapi")
 def project_project_resource_create_fastapi_cmd(
     project_id: int | None = typer.Argument(None, help="Project ID. Defaults to local .env when omitted."),
@@ -8977,30 +8943,6 @@ def project_project_resource_delete_dashboard_cmd(
     )
 
 
-@project_project_resource_group.command("delete_agent")
-def project_project_resource_delete_agent_cmd(
-    release_id: int = typer.Argument(..., help="Agent resource release ID."),
-    yes: bool = typer.Option(False, "--yes", help="Delete without confirmation."),
-    timeout: int | None = typer.Option(None, "--timeout", help="Request timeout in seconds"),
-):
-    """
-    Delete an agent resource release.
-
-    Examples
-    --------
-    ```bash
-    mainsequence project project_resource delete_agent 601
-    mainsequence project project_resource delete_agent 601 --yes
-    ```
-    """
-    _project_resource_release_delete_impl(
-        release_id=release_id,
-        expected_release_kind="agent",
-        yes=yes,
-        timeout=timeout,
-    )
-
-
 @project_project_resource_group.command("delete_fastapi")
 def project_project_resource_delete_fastapi_cmd(
     release_id: int = typer.Argument(..., help="FastAPI resource release ID."),
@@ -9574,10 +9516,14 @@ def project_jobs_list_cmd(
 @project_jobs_group.command("run")
 def project_jobs_run_cmd(
     job_id: int = pydantic_argument(JOB_MODEL_REF, "id", ..., help="Job ID to run."),
+    passthrough_args: list[str] | None = typer.Argument(
+        None,
+        help="Additional per-run args after `--`, for example `mainsequence project jobs run 91 -- --name demo`.",
+    ),
     command_args: list[str] | None = typer.Option(
         None,
-        "--command",
-        help="Per-run command argument. Repeat to send a list of strings to Job.run_job().",
+        "--arg",
+        help="Append one per-run arg to the saved job entrypoint. Repeatable. Does not replace the saved execution_path or app_name.",
     ),
     timeout: int | None = typer.Option(None, "--timeout", help="Request timeout in seconds"),
 ):
@@ -9585,21 +9531,43 @@ def project_jobs_run_cmd(
     Run a project job immediately.
 
     Uses SDK client `Job.run_job()` as the single source of truth.
+    Per-run args are appended to the saved job entrypoint; they do not replace it.
 
     Examples
     --------
     ```bash
     mainsequence project jobs run 91
-    mainsequence project jobs run 91 --command python --command -m --command jobs.daily
+    mainsequence project jobs run 91 --arg demo-from-cli
+    mainsequence project jobs run 91 -- --name demo-from-cli
     mainsequence project jobs run 91 --timeout 60
     ```
     """
     _require_login()
 
+    merged_command_args = list(command_args or [])
+    if passthrough_args:
+        merged_command_args.extend(str(arg) for arg in passthrough_args)
+
+    try:
+        job_payload = get_project_job(job_id, timeout=timeout)
+    except ApiError as e:
+        error(f"Project job fetch failed: {e}")
+        raise typer.Exit(1) from e
+
+    entrypoint = str(job_payload.get("execution_path") or "").strip()
+    if not entrypoint:
+        app_name = str(job_payload.get("app_name") or "").strip()
+        if app_name:
+            entrypoint = f"app:{app_name}"
+
+    if entrypoint:
+        effective_tokens = [entrypoint, *merged_command_args]
+        info(f"Effective run: {shlex.join(effective_tokens)}")
+
     try:
         payload = run_project_job(
             job_id=job_id,
-            command_args=list(command_args) if command_args else None,
+            command_args=merged_command_args or None,
             timeout=timeout,
         )
     except ApiError as e:
@@ -10625,7 +10593,7 @@ def project_refresh_token(
 def project_freeze_env(
     project_id: int | None = typer.Argument(None, help="Project ID"),
     path: str | None = typer.Option(None, "--path", help="Project directory"),
-    ensure_uv: bool = typer.Option(True, "--ensure-uv/--no-ensure-uv", help="Install uv into .venv if missing"),
+    ensure_uv: bool = typer.Option(True, "--ensure-uv/--no-ensure-uv", help="Allow resolving uv from PATH when it is not present inside .venv."),
 ):
     """
     Export pinned dependencies into `requirements.txt` using `uv`.
@@ -10637,7 +10605,7 @@ def project_freeze_env(
     path:
         Explicit local path.
     ensure_uv:
-        Install `uv` in `.venv` if missing.
+        Allow resolving `uv` from PATH when it is not present inside `.venv`.
 
     Examples
     --------
@@ -10736,7 +10704,7 @@ def project_sync(
         raise typer.Exit(1)
 
     steps = [
-        "pip install uv (in .venv)",
+        "resolve uv executable",
         f"uv version --bump {bump}",
         "uv lock",
         "uv sync",
@@ -11045,7 +11013,7 @@ def project_update_sdk(
     ensure_venv(project_dir)
 
     steps = [
-        "pip install uv (in .venv)",
+        "resolve uv executable",
         "uv lock --upgrade-package mainsequence",
         "uv sync",
     ]

{mainsequence-3.19.3 → mainsequence-3.19.5}/mainsequence/cli/local_ops.py

@@ -13,6 +13,7 @@ Local operations shared by several commands:
 
 import os
 import pathlib
+import shutil
 import subprocess
 import sys
 from dataclasses import dataclass
@@ -62,7 +63,7 @@ def ensure_venv(project_dir: pathlib.Path) -> VenvPaths:
 
 def ensure_uv_installed(project_dir: pathlib.Path, upgrade: bool = True) -> pathlib.Path:
     """
-    Ensure uv is installed inside the project's .venv.
+    Resolve a usable uv executable for the project workflow.
 
     Returns:
         Path to uv executable
@@ -71,18 +72,11 @@ def ensure_uv_installed(project_dir: pathlib.Path, upgrade: bool = True) -> path
     if vp.uv and vp.uv.exists():
         return vp.uv
 
-    args = [str(vp.python), "-m", "pip", "install"]
-    if upgrade:
-        args.append("--upgrade")
-    args.append("uv")
-    r = subprocess.run(args, cwd=str(project_dir))
-    if r.returncode != 0:
-        raise RuntimeError("Failed to install uv into the virtual environment.")
+    uv_bin = shutil.which("uv")
+    if uv_bin:
+        return pathlib.Path(uv_bin)
 
-    vp = venv_paths(project_dir)
-    if not vp.uv or not vp.uv.exists():
-        raise RuntimeError("uv installed but executable not found in .venv.")
-    return vp.uv
+    raise RuntimeError("uv executable not found. Install uv and ensure it is available in PATH.")
 
 
 def run_cmd(cmd: list[str], cwd: pathlib.Path, env: dict[str, str] | None = None) -> subprocess.CompletedProcess:

{mainsequence-3.19.3 → mainsequence-3.19.5}/mainsequence/client/command_center/workspace.py

@@ -101,7 +101,7 @@ class Workspace(LabelableObjectMixin, ShareableObjectMixin, CommandCenterBaseObj
         description="Free-form workspace description.",
     )
     type: WorkspaceType = Field(default=WorkspaceType.WORKSPACE)
-    public_url:str=Field(description="Public URL for workspace endpoint if exists.", default="")
+    public_url:str| None =Field(description="Public URL for workspace endpoint if exists.", default=None)
     created_at:datetime=Field()
     labels: list[str] = Field(
         default_factory=list,

{mainsequence-3.19.3 → mainsequence-3.19.5}/mainsequence/client/models_helpers.py

@@ -728,7 +728,7 @@ class Job(BaseObjectOrm, BasePydanticModel):
 
         payload: dict[str, Any] = {}
         if command_args is not None:
-            payload["command_args"] = command_args
+            payload["json"] = {"command_args": list(command_args)}
 
         r = make_request(
             s=s,

{mainsequence-3.19.3 → mainsequence-3.19.5}/mainsequence.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mainsequence
-Version: 3.19.3
+Version: 3.19.5
 Summary: Main Sequence SDK 
 Author-email: Main Sequence GmbH <dev@main-sequence.io>
 License: MainSequence GmbH SDK License Agreement
@@ -154,6 +154,7 @@ Recommended entry points:
   - [Working With Simple Tables](docs/tutorial/working_with_simple_tables.md)
   - [Create Your First API](docs/tutorial/create_your_first_api.md)
   - [Role-Based Access Control](docs/tutorial/role_based_access_control.md)
+  - [Turn Your Project Into an Agent](docs/tutorial/project_to_agent.md)
 - Knowledge:
   - [Data Nodes](docs/knowledge/data_nodes.md)
   - [Command Center](docs/knowledge/command_center/index.md)
@@ -209,6 +210,7 @@ From there, the normal learning path is:
 4. understand sharing and RBAC
 5. schedule jobs
 6. build dashboards or downstream consumers
+7. package the project as an agent-facing surface when the repository is ready
 
 ## Installation for development
 

{mainsequence-3.19.3 → mainsequence-3.19.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mainsequence"
-version = "3.19.3"
+version = "3.19.5"
 description = "Main Sequence SDK "
 readme = "README.md"
 requires-python = ">=3.11"

{mainsequence-3.19.3 → mainsequence-3.19.5}/tests/test_cli.py

@@ -5699,13 +5699,15 @@ def test_run_project_job_uses_client_model(cli_mod, monkeypatch):
         def get(cls, pk, timeout=None):
             captured["job_id_arg"] = pk
             return types.SimpleNamespace(
+                execution_path="scripts/test.py",
+                app_name=None,
                 run_job=lambda timeout=None, command_args=None: (
                     captured.update(command_args=command_args)
                     or {
-                    "id": 501,
-                    "job": pk,
-                    "status": "QUEUED",
-                    "unique_identifier": "jobrun_abc123",
+                        "id": 501,
+                        "job": pk,
+                        "status": "QUEUED",
+                        "unique_identifier": "jobrun_abc123",
                     }
                 )
             )
@@ -5728,6 +5730,8 @@ def test_run_project_job_uses_client_model(cli_mod, monkeypatch):
         "job": 91,
         "status": "QUEUED",
         "unique_identifier": "jobrun_abc123",
+        "effective_run": "scripts/test.py python -m jobs.daily",
+        "command_args": ["python", "-m", "jobs.daily"],
     }
 
 
@@ -7951,6 +7955,16 @@ def test_markets_asset_translation_table_detail(cli_mod, runner, monkeypatch):
 def test_project_jobs_run(cli_mod, runner, monkeypatch):
     monkeypatch.setattr(cli_mod, "_require_login", lambda: {"username": "u"})
     captured = {}
+    monkeypatch.setattr(
+        cli_mod,
+        "get_project_job",
+        lambda job_id, timeout=None: {
+            "id": job_id,
+            "name": "daily-run",
+            "execution_path": "scripts/test.py",
+            "app_name": None,
+        },
+    )
     monkeypatch.setattr(
         cli_mod,
         "run_project_job",
@@ -7963,24 +7977,68 @@ def test_project_jobs_run(cli_mod, runner, monkeypatch):
             "job": job_id,
             "status": "QUEUED",
             "unique_identifier": "jobrun_abc123",
+            "effective_run": "scripts/test.py --name demo-from-cli",
         },
     )
 
     result = runner.invoke(
         cli_mod.app,
-        ["project", "jobs", "run", "91", "--command", "python", "--command", "-m", "--command", "jobs.daily"],
+        ["project", "jobs", "run", "91", "--", "--name", "demo-from-cli"],
     )
     assert result.exit_code == 0
     assert captured == {
         "job_id": 91,
-        "command_args": ["python", "-m", "jobs.daily"],
+        "command_args": ["--name", "demo-from-cli"],
         "timeout": None,
     }
+    assert "Effective run: scripts/test.py --name demo-from-cli" in result.output
     assert "Project job run requested: job_id=91" in result.output
     assert "jobrun_abc123" in result.output
     assert "QUEUED" in result.output
 
 
+def test_project_jobs_run_with_arg_option(cli_mod, runner, monkeypatch):
+    monkeypatch.setattr(cli_mod, "_require_login", lambda: {"username": "u"})
+    captured = {}
+    monkeypatch.setattr(
+        cli_mod,
+        "get_project_job",
+        lambda job_id, timeout=None: {
+            "id": job_id,
+            "name": "daily-run",
+            "execution_path": "scripts/test.py",
+            "app_name": None,
+        },
+    )
+    monkeypatch.setattr(
+        cli_mod,
+        "run_project_job",
+        lambda job_id, command_args=None, timeout=None: captured.update(
+            job_id=job_id,
+            command_args=command_args,
+            timeout=timeout,
+        ) or {
+            "id": 501,
+            "job": job_id,
+            "status": "QUEUED",
+            "unique_identifier": "jobrun_abc123",
+            "effective_run": "scripts/test.py demo-from-cli",
+        },
+    )
+
+    result = runner.invoke(
+        cli_mod.app,
+        ["project", "jobs", "run", "91", "--arg", "demo-from-cli"],
+    )
+    assert result.exit_code == 0
+    assert captured == {
+        "job_id": 91,
+        "command_args": ["demo-from-cli"],
+        "timeout": None,
+    }
+    assert "Effective run: scripts/test.py demo-from-cli" in result.output
+
+
 def test_project_job_runs_list(cli_mod, runner, monkeypatch):
     monkeypatch.setattr(cli_mod, "_require_login", lambda: {"username": "u"})
     monkeypatch.setattr(

{mainsequence-3.19.3 → mainsequence-3.19.5}/tests/test_project_batch_jobs_from_file.py

@@ -177,3 +177,46 @@ def test_job_bulk_get_or_create_rejects_invalid_job_definition(tmp_path):
 
     with pytest.raises(ValueError, match=r"jobs\[0\] is invalid"):
         Job.bulk_get_or_create(yaml_file=jobs_file, project_id=123)
+
+
+def test_job_run_job_posts_command_args_as_json(monkeypatch):
+    models_helpers = _load_models_helpers_module()
+    Job = models_helpers.Job
+
+    captured = {}
+
+    class FakeResponse:
+        status_code = 202
+
+        def json(self):
+            return {"id": 501, "status": "QUEUED"}
+
+    monkeypatch.setattr(Job, "build_session", classmethod(lambda cls: object()))
+    monkeypatch.setattr(
+        Job,
+        "get_object_url",
+        classmethod(lambda cls: "https://backend.test/orm/api/pods/job"),
+    )
+
+    def _fake_make_request(*, s, loaders, r_type, url, payload, time_out=None):
+        captured["r_type"] = r_type
+        captured["url"] = url
+        captured["payload"] = payload
+        captured["timeout"] = time_out
+        return FakeResponse()
+
+    monkeypatch.setattr(models_helpers, "make_request", _fake_make_request)
+
+    job = Job(
+        id=91,
+        name="Simulated Prices",
+        project=123,
+        execution_path="scripts/simulated_prices_launcher.py",
+    )
+    out = job.run_job(timeout=30, command_args=["--name", "demo-from-cli"])
+
+    assert captured["r_type"] == "POST"
+    assert captured["url"] == "https://backend.test/orm/api/pods/job/91/run_job/"
+    assert captured["timeout"] == 30
+    assert captured["payload"] == {"json": {"command_args": ["--name", "demo-from-cli"]}}
+    assert out == {"id": 501, "status": "QUEUED"}