mainsequence 3.19.3__tar.gz → 3.19.6__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mainsequence
-Version: 3.19.3
+Version: 3.19.6
 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.6}/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.6}/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.6}/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.6}/agent_scaffold/skills/project_to_agent/SKILL.md

@@ -14,7 +14,7 @@ This skill must only be used for adding agentic capabilities to an existing proj
 - Create the required files and folders for agentic capabilities.
 - Verify that the project has the required local agent configuration files.
 - Verify that the project has skills that are aligned with its CLI capabilities.
-
+- Important: This skill does not require creation of any agent defintion. Do not create an agents folder nor an agent.py  build around the project capabilities and .agents skills this is a coding agent setup!
 ## This Skill Must Not Claim
 
 - That it knows how to build the entire project unless the work is directly related to adding agentic capabilities.

{mainsequence-3.19.3 → mainsequence-3.19.6}/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
 
@@ -2374,8 +2375,8 @@ def create_project_resource_release(
     Create a resource release via SDK client model.
 
     Single source of truth:
-      - delegates to `ProjectResource.create_dashboard()`, `ProjectResource.create_agent()`,
-        or `ProjectResource.create_fastapi()`
+      - delegates to `ProjectResource.create_dashboard()` or
+        `ProjectResource.create_fastapi()`
       - which in turn use `ResourceRelease.create()`
     """
     tokens = get_tokens()
@@ -2437,12 +2438,11 @@ def create_project_resource_release(
 
         create_method_name = {
             "streamlit_dashboard": "create_dashboard",
-            "agent": "create_agent",
             "fastapi": "create_fastapi",
         }.get(str(release_kind).strip())
         if not create_method_name:
             raise ApiError(
-                "release_kind must be one of: 'streamlit_dashboard', 'agent', 'fastapi'."
+                "release_kind must be one of: 'streamlit_dashboard', 'fastapi'."
             )
 
         create_method = getattr(resource, create_method_name, None)
@@ -4679,6 +4679,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 +4762,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.6}/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,
@@ -432,12 +434,10 @@ JOB_RUN_STATUS_PENDING = "PENDING"
 JOB_RUN_STATUS_RUNNING = "RUNNING"
 RESOURCE_RELEASE_RESOURCE_TYPE_MAP = {
     "streamlit_dashboard": "dashboard",
-    "agent": "agent",
     "fastapi": "fastapi",
 }
 RESOURCE_RELEASE_LABEL_MAP = {
     "streamlit_dashboard": "dashboard release",
-    "agent": "agent release",
     "fastapi": "FastAPI release",
 }
 LIST_FILTER_OPTION_HELP = (
@@ -8834,42 +8834,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 +8941,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 +9514,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 +9529,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 +10591,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 +10603,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 +10702,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 +11011,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.6}/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.6}/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.6}/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,
@@ -954,10 +954,10 @@ class ProjectResource(BaseObjectOrm, BasePydanticModel):
         description="Display name of the resource discovered in the project's repository.",
         examples=["analytics_dashboard.py"],
     )
-    resource_type: Literal["dashboard", "agent", "fastapi", "markdown"] | None = Field(
+    resource_type: Literal["dashboard",  "fastapi", "markdown"] | None = Field(
         None,
         title="Resource Type",
-        description="Type of the project resource. Allowed values are `dashboard`, `agent`, `fastapi`, and `markdown`.",
+        description="Type of the project resource. Allowed values are `dashboard`,  `fastapi`, and `markdown`.",
         examples=["dashboard", "fastapi", "markdown"],
     )
     code: str | None = Field(
@@ -1027,15 +1027,6 @@ class ProjectResource(BaseObjectOrm, BasePydanticModel):
             **kwargs,
         )
 
-    def create_agent(self, timeout=None, files=None, *args, **kwargs) -> ResourceRelease:
-        return self._create_release(
-            ResourceReleaseKind.AGENT,
-            timeout,
-            files,
-            *args,
-            **kwargs,
-        )
-
     def create_fastapi(self, timeout=None, files=None, *args, **kwargs) -> ResourceRelease:
         return self._create_release(
             ResourceReleaseKind.FAST_API,
@@ -1048,7 +1039,6 @@ class ProjectResource(BaseObjectOrm, BasePydanticModel):
 
 class ResourceReleaseKind(str, Enum):
     STREAMLIT_DASHBOARD = "streamlit_dashboard"
-    AGENT = "agent"
     FAST_API = "fastapi"
 
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mainsequence
-Version: 3.19.3
+Version: 3.19.6
 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.6}/pyproject.toml

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