mainsequence 8.1.18__tar.gz → 8.1.20.dev1__tar.gz

{mainsequence-8.1.18/mainsequence.egg-info → mainsequence-8.1.20.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mainsequence
-Version: 8.1.18
+Version: 8.1.20.dev1
 Summary: Main Sequence SDK 
 Author-email: Main Sequence GmbH <dev@main-sequence.io>
 License-Expression: LicenseRef-MainSequence-Proprietary

{mainsequence-8.1.18 → mainsequence-8.1.20.dev1}/agent_scaffold/skills/a2a_sdk_execution/SKILL.md

@@ -43,14 +43,16 @@ internally and sends a standard A2A message.
 
 ```bash
 mainsequence agent search "<discoveryPrompt>" \
-  --environment-uid "<organizationEnvironmentUid>" \
   --limit 10 \
   --json
 ```
 
-Use the canonical Organization Environment UID associated with the target
-CodeRepositoryBranch. It scopes discovery only; it does not create, assign, or override an
-Agent's environment.
+The SDK resolves the active Git branch once for the process and scopes discovery
+to its Organization Environment. Do not supply a branch or Environment UID.
+An unregistered branch fails only when discovery is attempted.
+For an exact Python lookup, use `Agent.filter(name="SentinelExecutor")` and
+inspect the returned Agent UID and `code_repository_branch_uid`; names are not
+unique routing authority.
 
 4. Treat the CLI output as authoritative.
 5. Prefer the highest `combined_score` when present.
@@ -321,7 +323,7 @@ handle for a different task or conversation.
 ## Deterministic Execution Path
 
 1. Build the discovery prompt.
-2. Run `mainsequence agent search "<discoveryPrompt>" --environment-uid "<organizationEnvironmentUid>" --limit <n> --json`.
+2. Run `mainsequence agent search "<discoveryPrompt>" --limit <n> --json`.
 3. Select the target agent.
 4. Create or resolve the target session with `mainsequence agent session get_or_create`.
 5. Use the returned session `uid`.

{mainsequence-8.1.18 → mainsequence-8.1.20.dev1}/mainsequence/cli/api.py

@@ -1161,16 +1161,14 @@ def delete_organization_team(
 
 def list_agents(
     *,
-    organization_environment_uid: str,
     timeout: int | None = None,
     filters: dict[str, Any] | None = None,
 ) -> list[dict[str, Any]]:
     """
-    List agents in one Organization Environment via the SDK client model.
+    List agents in the Git-resolved Organization Environment via the SDK client model.
     """
     try:
         read_params = dict(filters or {})
-        read_params["organization_environment_uid"] = organization_environment_uid
         payload = _run_sdk_model_operation(
             module_name="mainsequence.client.agent_runtime_models",
             class_name="Agent",
@@ -1293,12 +1291,11 @@ def get_agent_resource_usage(
 def semantic_search_agents(
     q: str,
     *,
-    organization_environment_uid: str,
     limit: int = 20,
     timeout: int | None = None,
 ) -> list[dict[str, Any]]:
     """
-    Search agents in one Organization Environment via `Agent.semantic_search()`.
+    Search agents in the Git-resolved Organization Environment.
     """
     try:
         payload = _run_sdk_model_operation(
@@ -1306,7 +1303,6 @@ def semantic_search_agents(
             class_name="Agent",
             operation=lambda ClientAgent: ClientAgent.semantic_search(
                 q,
-                organization_environment_uid=organization_environment_uid,
                 limit=limit,
                 timeout=timeout,
             ),

{mainsequence-8.1.18 → mainsequence-8.1.20.dev1}/mainsequence/cli/cli.py

@@ -3541,7 +3541,6 @@ def _render_owner_resource_usage(payload: dict[str, object], *, title: str) -> N
 
 
 def _agent_list_impl(
-    organization_environment_uid: str,
     timeout: int | None,
     filter_entries: list[str] | None,
     show_filters: bool,
@@ -3556,7 +3555,6 @@ def _agent_list_impl(
 
     try:
         agents = list_agents(
-            organization_environment_uid=organization_environment_uid,
             timeout=timeout,
             filters=filters,
         )
@@ -3630,7 +3628,6 @@ def _agent_detail_impl(
 def _agent_search_impl(
     *,
     q: str,
-    organization_environment_uid: str,
     limit: int,
     timeout: int | None,
 ) -> None:
@@ -3639,7 +3636,6 @@ def _agent_search_impl(
     try:
         results = semantic_search_agents(
             q,
-            organization_environment_uid=organization_environment_uid,
             limit=limit,
             timeout=timeout,
         )
@@ -4697,11 +4693,6 @@ def _print_time_index_table_search_section(
 
 @agent.command("list")
 def agent_list_cmd(
-    organization_environment_uid: uuid.UUID = typer.Option(
-        ...,
-        "--environment-uid",
-        help="Organization Environment UID that scopes Agent discovery.",
-    ),
     filter_entries: list[str] | None = typer.Option(None, "--filter", help=LIST_FILTER_OPTION_HELP),
     show_filters: bool = typer.Option(
         False, "--show-filters", help="Show the filters supported by this list command and exit."
@@ -4712,7 +4703,6 @@ def agent_list_cmd(
     List agents visible to the authenticated user.
     """
     _agent_list_impl(
-        organization_environment_uid=str(organization_environment_uid),
         timeout=timeout,
         filter_entries=filter_entries,
         show_filters=show_filters,
@@ -4799,11 +4789,6 @@ def agent_resource_usage_cmd(
 @agent.command("search")
 def agent_search_cmd(
     q: str = typer.Argument(..., help="Natural-language query to match against agents."),
-    organization_environment_uid: uuid.UUID = typer.Option(
-        ...,
-        "--environment-uid",
-        help="Organization Environment UID that scopes Agent discovery.",
-    ),
     limit: int = typer.Option(
         20, "--limit", min=1, max=100, help="Maximum number of ranked agent matches to return."
     ),
@@ -4823,7 +4808,6 @@ def agent_search_cmd(
     """
     _agent_search_impl(
         q=q,
-        organization_environment_uid=str(organization_environment_uid),
         limit=limit,
         timeout=timeout,
     )

{mainsequence-8.1.18 → mainsequence-8.1.20.dev1}/mainsequence/client/agent_runtime_models.py

@@ -12,7 +12,12 @@ from typing import Any, ClassVar, Literal
 import requests
 from pydantic import ConfigDict, Field, model_validator
 
-from .base import BaseObjectOrm, BasePydanticModel, ShareableObjectMixin
+from .base import (
+    BaseObjectOrm,
+    BasePydanticModel,
+    CurrentCodeRepositoryEnvironmentResourceMixin,
+    ShareableObjectMixin,
+)
 from .exceptions import ApiError, raise_for_response
 from .observability import (
     EnvironmentLogSearchMixin,
@@ -465,6 +470,7 @@ def _runtime_access_retry_seconds(access: AgentSessionRuntimeAccess) -> float:
 
 
 class Agent(
+    CurrentCodeRepositoryEnvironmentResourceMixin,
     EnvironmentLogSearchMixin,
     OwnerLogMixin,
     OwnerResourceUsageMixin,
@@ -482,14 +488,22 @@ class Agent(
 
     FILTERSET_FIELDS: ClassVar[dict[str, list[str]] | None] = {
         "uid": ["exact", "in"],
+        "name": ["exact"],
         "search": ["exact"],
     }
     FILTER_VALUE_NORMALIZERS: ClassVar[dict[str, str]] = {
         "uid": "uid",
         "uid__in": "uid",
+        "name": "str",
         "search": "str",
     }
 
+    @classmethod
+    def _sdk_owned_query_context(cls, operation: str) -> dict[str, str]:
+        if operation in {f"{cls.__name__}.filter", f"{cls.__name__}.semantic_search"}:
+            return super()._sdk_owned_query_context(operation)
+        return {}
+
     @classmethod
     def search_logs(
         cls,
@@ -522,16 +536,6 @@ class Agent(
             timeout=timeout,
         )
 
-    READ_QUERY_PARAMS: ClassVar[dict[str, str]] = {
-        "organization_environment_uid": "uid",
-    }
-    READ_QUERY_PARAM_DESCRIPTIONS: ClassVar[dict[str, str]] = {
-        "organization_environment_uid": (
-            "Required Organization Environment boundary for Agent discovery. "
-            "This scopes reads and does not assign an environment to an Agent."
-        ),
-    }
-
     uid: str | None = Field(None, description="Public UID of the agent resource.")
     name: str = Field(
         ..., description="Human-readable display name for the agent inside the organization."
@@ -667,7 +671,6 @@ class Agent(
         cls,
         q: str,
         *,
-        organization_environment_uid: str,
         limit: int = 20,
         timeout=None,
     ) -> list[AgentSemanticSearchResult]:
@@ -688,12 +691,9 @@ class Agent(
             raise ValueError("limit must be between 1 and 100")
 
         body: dict[str, Any] = {
-            "organization_environment_uid": cls._coerce_filter_uid(
-                organization_environment_uid,
-                field_name="organization_environment_uid",
-            ),
             "q": q,
             "limit": limit,
+            **cls._sdk_owned_query_context(f"{cls.__name__}.semantic_search"),
         }
 
         payload = {"json": serialize_to_json(body)}

{mainsequence-8.1.18 → mainsequence-8.1.20.dev1/mainsequence.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mainsequence
-Version: 8.1.18
+Version: 8.1.20.dev1
 Summary: Main Sequence SDK 
 Author-email: Main Sequence GmbH <dev@main-sequence.io>
 License-Expression: LicenseRef-MainSequence-Proprietary

{mainsequence-8.1.18 → mainsequence-8.1.20.dev1}/mainsequence.egg-info/SOURCES.txt

@@ -105,6 +105,7 @@ tests/test_code_repository_documentation_contract.py
 tests/test_code_repository_runtime_context.py
 tests/test_code_repository_skills.py
 tests/test_dependency_extras.py
+tests/test_dev_release_version.py
 tests/test_duckdb_interface_dimensions.py
 tests/test_environment_resource_context.py
 tests/test_environment_response_contracts.py

{mainsequence-8.1.18 → mainsequence-8.1.20.dev1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mainsequence"
-version = "8.1.18"
+version = "8.1.20.dev1"
 description = "Main Sequence SDK "
 readme = "README.md"
 requires-python = ">=3.13"
@@ -95,6 +95,23 @@ publish-url = "https://test.pypi.org/legacy/"
 explicit = true
 
 
+# --------------------
+# Testing (pytest)
+# --------------------
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+# Put the repository root on sys.path so tests can import `scripts`. `pytest`
+# invoked as `python -m pytest` gets this from the CWD, but the `pytest`
+# entrypoint (what `uv run pytest` and CI use) does not.
+pythonpath = ["."]
+# `live` tests talk to a real backend and need credentials, so they are
+# deselected by default. CI and a plain `pytest` therefore run offline.
+# Run them explicitly with `pytest -m live`.
+addopts = "-m 'not live'"
+markers = [
+  "live: talks to a live Main Sequence backend and needs credentials; deselected unless `-m live` is passed",
+]
+
 # --------------------
 # Formatting (Black)
 # --------------------

{mainsequence-8.1.18 → mainsequence-8.1.20.dev1}/tests/test_cli.py

@@ -579,7 +579,6 @@ def test_list_organization_teams_uses_client_model(cli_mod, monkeypatch):
 def test_list_agents_uses_client_model(cli_mod, monkeypatch):
     api_mod = importlib.import_module("mainsequence.cli.api")
     captured = {}
-    environment_uid = "22222222-2222-4222-8222-222222222222"
 
     class FakeAgent:
         def __init__(self, uid, name):
@@ -607,7 +606,6 @@ def test_list_agents_uses_client_model(cli_mod, monkeypatch):
     monkeypatch.setattr(api_mod, "_run_sdk_model_operation", _run_sdk_model_operation)
 
     out = api_mod.list_agents(
-        organization_environment_uid=environment_uid,
         timeout=9,
         filters={"search": "Research"},
     )
@@ -615,10 +613,7 @@ def test_list_agents_uses_client_model(cli_mod, monkeypatch):
         "module_name": "mainsequence.client.agent_runtime_models",
         "class_name": "Agent",
         "timeout": 9,
-        "filters": {
-            "search": "Research",
-            "organization_environment_uid": environment_uid,
-        },
+        "filters": {"search": "Research"},
     }
     assert out == [
         {
@@ -677,7 +672,6 @@ def test_get_code_repository_repository_uses_public_client_model(cli_mod, monkey
 def test_semantic_search_agents_uses_client_model(cli_mod, monkeypatch):
     api_mod = importlib.import_module("mainsequence.cli.api")
     captured = {}
-    environment_uid = "22222222-2222-4222-8222-222222222222"
 
     class FakeSearchResult:
         def __init__(self):
@@ -710,12 +704,10 @@ def test_semantic_search_agents_uses_client_model(cli_mod, monkeypatch):
                 cls,
                 q,
                 *,
-                organization_environment_uid,
                 limit=20,
                 timeout=None,
             ):
                 captured["q"] = q
-                captured["organization_environment_uid"] = organization_environment_uid
                 captured["limit"] = limit
                 captured["timeout"] = timeout
                 return [FakeSearchResult()]
@@ -726,7 +718,6 @@ def test_semantic_search_agents_uses_client_model(cli_mod, monkeypatch):
 
     out = api_mod.semantic_search_agents(
         "data research",
-        organization_environment_uid=environment_uid,
         limit=10,
         timeout=17,
     )
@@ -734,7 +725,6 @@ def test_semantic_search_agents_uses_client_model(cli_mod, monkeypatch):
         "module_name": "mainsequence.client.agent_runtime_models",
         "class_name": "Agent",
         "q": "data research",
-        "organization_environment_uid": environment_uid,
         "limit": 10,
         "timeout": 17,
     }
@@ -6322,12 +6312,11 @@ def test_code_repository_code_repository_resource_delete_fastapi_requires_confir
 
 
 def test_agent_list(cli_mod, runner, monkeypatch):
-    environment_uid = "22222222-2222-4222-8222-222222222222"
     monkeypatch.setattr(cli_mod, "_require_login", lambda: {"username": "u"})
     monkeypatch.setattr(
         cli_mod,
         "list_agents",
-        lambda organization_environment_uid, timeout=None, filters=None: [
+        lambda timeout=None, filters=None: [
             {
                 "uid": "e0e75693-4110-464c-93e0-82c7fd9c9a23",
                 "name": "Research Copilot",
@@ -6343,7 +6332,7 @@ def test_agent_list(cli_mod, runner, monkeypatch):
 
     result = runner.invoke(
         cli_mod.app,
-        ["agent", "list", "--environment-uid", environment_uid],
+        ["agent", "list", "--filter", "name=SentinelExecutor"],
     )
     assert result.exit_code == 0
     assert "Agents" in result.output
@@ -6355,12 +6344,11 @@ def test_agent_list(cli_mod, runner, monkeypatch):
 
 
 def test_agent_list_json(cli_mod, runner, monkeypatch):
-    environment_uid = "22222222-2222-4222-8222-222222222222"
     monkeypatch.setattr(cli_mod, "_require_login", lambda: {"username": "u"})
     monkeypatch.setattr(
         cli_mod,
         "list_agents",
-        lambda organization_environment_uid, timeout=None, filters=None: [
+        lambda timeout=None, filters=None: [
             {
                 "uid": "e0e75693-4110-464c-93e0-82c7fd9c9a23",
                 "name": "Research Copilot",
@@ -6376,7 +6364,7 @@ def test_agent_list_json(cli_mod, runner, monkeypatch):
 
     result = runner.invoke(
         cli_mod.app,
-        ["agent", "list", "--environment-uid", environment_uid, "--json"],
+        ["agent", "list", "--json"],
     )
     assert result.exit_code == 0
     payload = json.loads(result.output)
@@ -6386,14 +6374,12 @@ def test_agent_list_json(cli_mod, runner, monkeypatch):
 
 def test_agent_search(cli_mod, runner, monkeypatch):
     captured = {}
-    environment_uid = "22222222-2222-4222-8222-222222222222"
     monkeypatch.setattr(cli_mod, "_require_login", lambda: {"username": "u"})
 
-    def _search(q, *, organization_environment_uid, limit=20, timeout=None):
+    def _search(q, *, limit=20, timeout=None):
         captured.update(
             {
                 "q": q,
-                "organization_environment_uid": organization_environment_uid,
                 "limit": limit,
                 "timeout": timeout,
             }
@@ -6417,8 +6403,6 @@ def test_agent_search(cli_mod, runner, monkeypatch):
             "agent",
             "search",
             "data research",
-            "--environment-uid",
-            environment_uid,
             "--limit",
             "10",
             "--timeout",
@@ -6428,7 +6412,6 @@ def test_agent_search(cli_mod, runner, monkeypatch):
     assert result.exit_code == 0
     assert captured == {
         "q": "data research",
-        "organization_environment_uid": environment_uid,
         "limit": 10,
         "timeout": 17,
     }
@@ -6442,7 +6425,6 @@ def test_agent_search(cli_mod, runner, monkeypatch):
 
 
 def test_agent_search_json(cli_mod, runner, monkeypatch):
-    environment_uid = "22222222-2222-4222-8222-222222222222"
     monkeypatch.setattr(cli_mod, "_require_login", lambda: {"username": "u"})
     monkeypatch.setattr(
         cli_mod,
@@ -6465,8 +6447,6 @@ def test_agent_search_json(cli_mod, runner, monkeypatch):
             "agent",
             "search",
             "data research",
-            "--environment-uid",
-            environment_uid,
             "--json",
         ],
     )

{mainsequence-8.1.18 → mainsequence-8.1.20.dev1}/tests/test_client.py

@@ -4,6 +4,11 @@ import pytest
 
 import mainsequence.client as msc
 
+# Every test in this module drives a real backend over the network and needs
+# SDK credentials, so none of them can run in CI. See `[tool.pytest.ini_options]`
+# in pyproject.toml: `pytest` deselects them, `pytest -m live` runs them.
+pytestmark = pytest.mark.live
+
 
 def test_create_code_repository():
     ds = msc.DataSource.filter(status=msc.DataSource.STATUS_AVAILABLE)[0]

{mainsequence-8.1.18 → mainsequence-8.1.20.dev1}/tests/test_code_repository_batch_jobs_from_file.py

@@ -6,6 +6,32 @@ import types
 import pytest
 
 
+def _snapshot_mainsequence_modules() -> dict[str, types.ModuleType]:
+    return {
+        name: module
+        for name, module in sys.modules.items()
+        if name == "mainsequence" or name.startswith("mainsequence.")
+    }
+
+
+@pytest.fixture(autouse=True)
+def _restore_mainsequence_modules():
+    """Undo the stub packages this module installs into ``sys.modules``.
+
+    ``_load_models_helpers_module`` replaces the real ``mainsequence`` packages
+    with stubs so ``models_helpers`` can be imported without the heavy client
+    stack. Without this fixture the stubs leak into every test module that runs
+    afterwards, and ``monkeypatch.setattr("mainsequence.client....")`` there
+    fails with ``module 'mainsequence' has no attribute 'client'``.
+    """
+    snapshot = _snapshot_mainsequence_modules()
+    yield
+    for name in tuple(sys.modules):
+        if name == "mainsequence" or name.startswith("mainsequence."):
+            sys.modules.pop(name, None)
+    sys.modules.update(snapshot)
+
+
 def _load_models_helpers_module():
     repo_root = pathlib.Path(__file__).resolve().parents[1]
     pkg_root = repo_root / "mainsequence"

mainsequence-8.1.20.dev1/tests/test_dev_release_version.py

@@ -0,0 +1,118 @@
+"""Contract for the development-release version computed by the publish workflow.
+
+The standard these tests pin down is documented in
+`docs/knowledge/release_process.md`.
+"""
+
+from __future__ import annotations
+
+import pytest
+from packaging.version import Version
+
+from scripts import dev_release_version
+
+
+def _files(*, yanked: bool = False) -> list[dict[str, object]]:
+    return [{"filename": "mainsequence-x-py3-none-any.whl", "yanked": yanked}]
+
+
+def test_latest_final_ignores_development_and_pre_releases():
+    releases = {
+        "8.1.19": _files(),
+        "8.1.20.dev41": _files(),
+        "8.2.0rc1": _files(),
+        "8.1.19.post1": _files(),
+    }
+
+    assert dev_release_version.latest_final_version(releases) == Version("8.1.19")
+
+
+def test_latest_final_ignores_releases_with_no_installable_file():
+    releases = {
+        "8.1.19": _files(),
+        "9.0.0": [],
+        "9.1.0": _files(yanked=True),
+    }
+
+    assert dev_release_version.latest_final_version(releases) == Version("8.1.19")
+
+
+def test_latest_final_keeps_a_release_with_one_file_left():
+    releases = {
+        "8.1.19": _files(),
+        "8.2.0": [
+            {"filename": "mainsequence-8.2.0.tar.gz", "yanked": True},
+            {"filename": "mainsequence-8.2.0-py3-none-any.whl", "yanked": False},
+        ],
+    }
+
+    assert dev_release_version.latest_final_version(releases) == Version("8.2.0")
+
+
+def test_latest_final_orders_numerically_not_lexically():
+    releases = {"8.1.9": _files(), "8.1.10": _files(), "8.1.2": _files()}
+
+    assert dev_release_version.latest_final_version(releases) == Version("8.1.10")
+
+
+def test_latest_final_skips_unparseable_versions():
+    releases = {"8.1.19": _files(), "not-a-version": _files()}
+
+    assert dev_release_version.latest_final_version(releases) == Version("8.1.19")
+
+
+def test_latest_final_requires_at_least_one_installable_release():
+    with pytest.raises(dev_release_version.DevVersionError):
+        dev_release_version.latest_final_version({"9.0.0": []})
+
+
+def test_dev_version_carries_the_next_patch_number():
+    assert dev_release_version.dev_version(Version("8.1.19"), 41) == "8.1.20.dev41"
+
+
+def test_dev_version_sorts_between_the_current_and_the_next_release():
+    computed = Version(dev_release_version.dev_version(Version("8.1.19"), 41))
+
+    assert Version("8.1.19") < computed < Version("8.1.20")
+
+
+def test_dev_version_is_a_development_release_so_pip_skips_it_by_default():
+    computed = Version(dev_release_version.dev_version(Version("8.1.19"), 41))
+
+    assert computed.is_devrelease
+
+
+def test_dev_version_rejects_a_negative_run_number():
+    with pytest.raises(dev_release_version.DevVersionError):
+        dev_release_version.dev_version(Version("8.1.19"), -1)
+
+
+def test_apply_version_rewrites_only_the_project_version():
+    pyproject = '[project]\nname = "mainsequence"\nversion = "8.1.19"\n\n[tool.other]\nversion = "1.0.0"\n'
+
+    rewritten = dev_release_version.apply_version(pyproject, "8.1.20.dev41")
+
+    assert 'version = "8.1.20.dev41"' in rewritten
+    assert rewritten.count('version = "1.0.0"') == 1
+
+
+def test_apply_version_refuses_a_pyproject_without_a_project_version():
+    with pytest.raises(dev_release_version.DevVersionError):
+        dev_release_version.apply_version('[project]\nname = "mainsequence"\n', "8.1.20.dev41")
+
+
+def test_read_declared_version_reports_the_repository_version():
+    text = dev_release_version.PYPROJECT.read_text(encoding="utf-8")
+
+    declared = dev_release_version.read_declared_version(text)
+
+    assert declared is not None
+    Version(declared)
+
+
+def test_the_repository_pyproject_accepts_a_rewritten_version():
+    text = dev_release_version.PYPROJECT.read_text(encoding="utf-8")
+
+    rewritten = dev_release_version.apply_version(text, "8.1.20.dev41")
+
+    assert dev_release_version.read_declared_version(rewritten) == "8.1.20.dev41"