server4agent 0.7.0__tar.gz → 0.9.0__tar.gz

{server4agent-0.7.0 → server4agent-0.9.0}/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## 0.9.0
+
+Tuning runs are removed. The API no longer has the `/tuning/sessions`
+endpoints, so neither client calls them. This is a breaking change.
+
+- `client.tuning` is gone from both clients, with `list()`, `start()`, `get()`
+  and `report()`, and so are the `TuningSession` and `AsyncTuningSession`
+  handles and the `TuningStart` and `TuningStatus` types.
+- `WEBHOOK_EVENTS` no longer lists `tuning.started` or `tuning.completed`, and
+  `webhooks.create()` with either is refused as an unknown event. Nothing
+  sends them any more. A webhook created before they were retired may still
+  have them stored; `webhooks.list()` leaves them off its `events`.
+
+## 0.8.0
+
+Projects can put their URL behind a password.
+
+- `ProjectAccess` gains `"password"`: a visitor to the project's URL is asked
+  for a password the owner set, and gets in without any account. A project
+  read from the API can now report it, so code that branches on `access`
+  should handle the new value.
+- `projects.create()` and `project.update()` (sync and async, and the flat
+  `client.projects.update(project_id, ...)`) take `access_password`. It is
+  required when switching to `access="password"` unless a password is already
+  set, and refused with any other access. Sent on its own to a password
+  project, it changes the password and signs out everyone who used the old
+  one. Switching to another access discards it. It is at least 4 characters
+  (a 4 digit code works), stored encrypted, and never returned by the API.
+
 ## 0.7.0
 
 The client now covers every operation in the REST API. Everything below is

{server4agent-0.7.0 → server4agent-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: server4agent
-Version: 0.7.0
+Version: 0.9.0
 Summary: Python client for the Server4Agent REST API — sync + async, typed, with retries.
 Project-URL: Homepage, https://www.server4agent.com
 Project-URL: Documentation, https://www.server4agent.com/docs/sdks
@@ -99,6 +99,8 @@ server.refresh()                    # re-fetch in place
 
 project = client.projects.get("prj_xyz")
 project.update(visibility="public")
+# Ask visitors for a password before the URL opens. No account needed to get in.
+project.update(access="password", access_password="a long shared passphrase")
 ```
 
 Binary files (e.g. a generated `.xlsx`) round-trip through `write`/`read_binary`
@@ -227,18 +229,6 @@ if me.usage.blocked:
     print("new tasks are refused:", me.usage.reason)
 ```
 
-## Tuning runs
-
-A tuning run fixes an agent from an evaluation platform's report, then reports
-back what changed. Reading a session is what advances it, so `wait()` polls it
-to `reported` or `failed`:
-
-```python
-start = client.tuning.start("prop_123", project_id=project.id)
-session = start.session.wait(on_poll=lambda s: print(s.status))
-print(session.change_summary, session.changed_files)
-```
-
 ## Errors
 
 Every failure is a subclass of `Server4AgentError`, so you can catch broadly or
@@ -296,7 +286,7 @@ Runnable scripts in [`examples/`](examples/):
 ## API surface
 
 `servers`, `projects`, `templates`, `tasks`, `builds`, `files`, `secrets`,
-`tuning`, `keys`, `webhooks`, and `client.me()`. Every REST operation has a
+`keys`, `webhooks`, and `client.me()`. Every REST operation has a
 method on both clients; see the
 [REST API docs](https://www.server4agent.com/docs/api) for the endpoints each
 one wraps.

{server4agent-0.7.0 → server4agent-0.9.0}/README.md

@@ -73,6 +73,8 @@ server.refresh()                    # re-fetch in place
 
 project = client.projects.get("prj_xyz")
 project.update(visibility="public")
+# Ask visitors for a password before the URL opens. No account needed to get in.
+project.update(access="password", access_password="a long shared passphrase")
 ```
 
 Binary files (e.g. a generated `.xlsx`) round-trip through `write`/`read_binary`
@@ -201,18 +203,6 @@ if me.usage.blocked:
     print("new tasks are refused:", me.usage.reason)
 ```
 
-## Tuning runs
-
-A tuning run fixes an agent from an evaluation platform's report, then reports
-back what changed. Reading a session is what advances it, so `wait()` polls it
-to `reported` or `failed`:
-
-```python
-start = client.tuning.start("prop_123", project_id=project.id)
-session = start.session.wait(on_poll=lambda s: print(s.status))
-print(session.change_summary, session.changed_files)
-```
-
 ## Errors
 
 Every failure is a subclass of `Server4AgentError`, so you can catch broadly or
@@ -270,7 +260,7 @@ Runnable scripts in [`examples/`](examples/):
 ## API surface
 
 `servers`, `projects`, `templates`, `tasks`, `builds`, `files`, `secrets`,
-`tuning`, `keys`, `webhooks`, and `client.me()`. Every REST operation has a
+`keys`, `webhooks`, and `client.me()`. Every REST operation has a
 method on both clients; see the
 [REST API docs](https://www.server4agent.com/docs/api) for the endpoints each
 one wraps.

{server4agent-0.7.0 → server4agent-0.9.0}/server4agent/__init__.py

@@ -4,7 +4,6 @@ from ._async.client import (
     AsyncProject,
     AsyncServer,
     AsyncTask,
-    AsyncTuningSession,
 )
 from ._models import (
     AccountUsage,
@@ -29,12 +28,10 @@ from ._models import (
     ProjectVisibility,
     Secret,
     SecretInput,
-    TuningStart,
-    TuningStatus,
     WEBHOOK_EVENTS,
     Webhook,
 )
-from ._sync.client import Build, Project, Server, Server4Agent, Task, TuningSession
+from ._sync.client import Build, Project, Server, Server4Agent, Task
 from ._version import __version__
 from .errors import (
     APIConnectionError,
@@ -61,13 +58,11 @@ __all__ = [
     "Project",
     "Task",
     "Build",
-    "TuningSession",
     # async handles
     "AsyncServer",
     "AsyncProject",
     "AsyncTask",
     "AsyncBuild",
-    "AsyncTuningSession",
     # data types
     "ApiKey",
     "CreatedApiKey",
@@ -78,7 +73,6 @@ __all__ = [
     "AppStart",
     "Me",
     "AccountUsage",
-    "TuningStart",
     "ExecResult",
     "BuildStep",
     "ProjectTemplate",
@@ -93,7 +87,6 @@ __all__ = [
     "ProjectVisibility",
     "ProjectAccess",
     "ProjectInitPhase",
-    "TuningStatus",
     "WEBHOOK_EVENTS",
     # errors
     "Server4AgentError",

{server4agent-0.7.0 → server4agent-0.9.0}/server4agent/_async/client.py

@@ -27,9 +27,6 @@ from .._models import (
     ServerKind,
     ServerTier,
     TASK_TERMINAL_STATES,
-    TUNING_TERMINAL_STATES,
-    TuningStart,
-    TuningStatus,
     Webhook,
     _Record,
     bundle_b64,
@@ -37,7 +34,6 @@ from .._models import (
     parse_project,
     parse_server,
     parse_task,
-    parse_tuning_session,
     secret_inputs,
 )
 from .._transport import quote_segment as _seg
@@ -174,6 +170,7 @@ class AsyncProject(_Record):
         description: Optional[str] = None,
         visibility: Optional[str] = None,
         access: Optional[str] = None,
+        access_password: Optional[str] = None,
         lifecycle: Optional[str] = None,
         run_plan: Optional[Mapping[str, Any]] = None,
     ) -> "AsyncProject":
@@ -184,6 +181,7 @@ class AsyncProject(_Record):
                 "description": description,
                 "visibility": visibility,
                 "access": access,
+                "access_password": access_password,
                 "lifecycle": lifecycle,
                 "run_plan": dict(run_plan) if run_plan is not None else None,
             }.items()
@@ -315,74 +313,6 @@ class AsyncBuild(_Record):
         return self
 
 
-class AsyncTuningSession(_Record):
-    """A tuning run. Reading it advances it; ``wait()`` polls until it is
-    ``reported`` or ``failed``."""
-    id: str
-    server_id: str
-    project_id: str
-    run_id: Optional[str]
-    build_run_id: Optional[str]
-    proposal_id: str
-    evaluation_api_base: str
-    key_secret: str
-    brief_path: Optional[str]
-    brief_revision: Optional[str]
-    status: str
-    change_summary: Optional[str]
-    changed_files: List[str]
-    deployment_url: Optional[str]
-    reported_at: Optional[str]
-    report_error: Optional[str]
-    created_at: str
-    updated_at: str
-    run: Optional["AsyncTask"]
-
-    def __init__(self, transport: AsyncTransport, raw: dict, run: Optional[dict] = None) -> None:
-        self._t = transport
-        self.__dict__.update(parse_tuning_session(raw))
-        self.run = AsyncTask(transport, run) if run else None
-
-    async def refresh(self) -> "AsyncTuningSession":
-        r = await self._t.request("GET", f"/tuning/sessions/{_seg(self.id)}")
-        self.__dict__.update(parse_tuning_session(r["session"]))
-        self.run = AsyncTask(self._t, r["run"]) if r.get("run") else None
-        return self
-
-    async def wait(
-        self,
-        *,
-        poll_interval: float = 2.0,
-        timeout: float = 1800.0,
-        on_poll: Optional[Callable[["AsyncTuningSession"], Union[None, Awaitable[None]]]] = None,
-    ) -> "AsyncTuningSession":
-        """Await until the session is reported or failed. ``on_poll`` (sync or
-        async) is called with ``self`` after each refresh."""
-        deadline = time.monotonic() + timeout
-        while self.status not in TUNING_TERMINAL_STATES:
-            if time.monotonic() >= deadline:
-                raise APITimeoutError(f"Tuning session {self.id} still {self.status!r} after {timeout}s.")
-            await asyncio.sleep(poll_interval)
-            await self.refresh()
-            if on_poll is not None:
-                res = on_poll(self)
-                if res is not None:
-                    await res
-        return self
-
-    async def report(
-        self,
-        *,
-        change_summary: Optional[str] = None,
-        changed_files: Optional[Sequence[str]] = None,
-        deployment_url: Optional[str] = None,
-        failed: Optional[bool] = None,
-    ) -> "AsyncTuningSession":
-        r = await _report_tuning(self._t, self.id, change_summary, changed_files, deployment_url, failed)
-        self.__dict__.update(parse_tuning_session(r["session"]))
-        return self
-
-
 # =============================================================================
 # Scoped sub-resources
 # =============================================================================
@@ -403,6 +333,7 @@ class _ScopedProjects:
         description: Optional[str] = None,
         visibility: Optional[str] = None,
         access: Optional[str] = None,
+        access_password: Optional[str] = None,
         lifecycle: Optional[str] = None,
         template: Optional[str] = None,
         source: Optional[Mapping[str, Any]] = None,
@@ -416,6 +347,7 @@ class _ScopedProjects:
                 "description": description,
                 "visibility": visibility,
                 "access": access,
+                "access_password": access_password,
                 "lifecycle": lifecycle,
                 "template": template,
                 "source": dict(source) if source is not None else None,
@@ -582,27 +514,6 @@ async def _logs(
     return LogsSnapshot.parse(r["logs"]) if r.get("logs") is not None else None
 
 
-async def _report_tuning(
-    t: AsyncTransport,
-    session_id: str,
-    change_summary: Optional[str],
-    changed_files: Optional[Sequence[str]],
-    deployment_url: Optional[str],
-    failed: Optional[bool],
-) -> dict:
-    body = {
-        k: v
-        for k, v in {
-            "change_summary": change_summary,
-            "changed_files": list(changed_files) if changed_files is not None else None,
-            "deployment_url": deployment_url,
-            "failed": failed,
-        }.items()
-        if v is not None
-    }
-    return await t.request("PATCH", f"/tuning/sessions/{_seg(session_id)}", body=body)
-
-
 # =============================================================================
 # Top-level resources
 # =============================================================================
@@ -822,58 +733,6 @@ class SecretsResource:
         return await _ScopedSecrets(self._t, f"/projects/{_seg(project_id)}/secrets").set(secrets)
 
 
-class TuningResource:
-    def __init__(self, transport: AsyncTransport) -> None:
-        self._t = transport
-
-    async def list(
-        self, *, project_id: Optional[str] = None, status: Optional[TuningStatus] = None
-    ) -> List[AsyncTuningSession]:
-        r = await self._t.request("GET", "/tuning/sessions", query={"project_id": project_id, "status": status})
-        return [AsyncTuningSession(self._t, s) for s in r["sessions"]]
-
-    async def start(
-        self,
-        proposal_id: str,
-        *,
-        project_id: Optional[str] = None,
-        server_id: Optional[str] = None,
-        evaluation_api_base: Optional[str] = None,
-        key_secret: Optional[str] = None,
-    ) -> TuningStart[AsyncTuningSession]:
-        body = {
-            k: v
-            for k, v in {
-                "proposal_id": proposal_id,
-                "project_id": project_id,
-                "server_id": server_id,
-                "evaluation_api_base": evaluation_api_base,
-                "key_secret": key_secret,
-            }.items()
-            if v is not None
-        }
-        r = await self._t.request("POST", "/tuning/sessions", body=body)
-        return TuningStart.parse(AsyncTuningSession(self._t, r["session"]), r)
-
-    async def get(self, tuning_session_id: str) -> AsyncTuningSession:
-        r = await self._t.request("GET", f"/tuning/sessions/{_seg(tuning_session_id)}")
-        return AsyncTuningSession(self._t, r["session"], r.get("run"))
-
-    async def report(
-        self,
-        tuning_session_id: str,
-        *,
-        change_summary: Optional[str] = None,
-        changed_files: Optional[Sequence[str]] = None,
-        deployment_url: Optional[str] = None,
-        failed: Optional[bool] = None,
-    ) -> AsyncTuningSession:
-        r = await _report_tuning(
-            self._t, tuning_session_id, change_summary, changed_files, deployment_url, failed
-        )
-        return AsyncTuningSession(self._t, r["session"])
-
-
 class KeysResource:
     def __init__(self, transport: AsyncTransport) -> None:
         self._t = transport
@@ -961,7 +820,6 @@ class AsyncServer4Agent:
         self.builds = BuildsResource(self._t)
         self.files = FilesResource(self._t)
         self.secrets = SecretsResource(self._t)
-        self.tuning = TuningResource(self._t)
         self.keys = KeysResource(self._t)
         self.webhooks = WebhooksResource(self._t)
 

{server4agent-0.7.0 → server4agent-0.9.0}/server4agent/_models.py

@@ -21,9 +21,10 @@ ServerStatus = Literal["running", "sleeping", "building"]
 ServerAction = Literal["start", "stop", "restart"]
 ProjectVisibility = Literal["public", "private"]
 #: Who may open a public project's URL. "team" puts it behind a Server4Agent
-#: sign-in and membership of the owning account; "public" is anyone with the
-#: link, which is the default and how every project behaved before this.
-ProjectAccess = Literal["public", "team"]
+#: sign-in and membership of the owning account; "password" asks for a password
+#: the owner set (``access_password``) and needs no account; "public" is anyone
+#: with the link, which is the default and how every project behaved before this.
+ProjectAccess = Literal["public", "team", "password"]
 ProjectLifecycle = Literal["persistent", "ephemeral"]
 ProjectRuntimeStatus = Literal["unbuilt", "running", "paused"]
 #: Where a project's bring-up has got to, from seeding the workspace to a
@@ -37,15 +38,10 @@ BuildStatus = Literal["queued", "running", "completed"]
 #: ``"live"`` when the project's URL answered within the deploy's wait,
 #: ``"publishing"`` when it is public but had not answered yet.
 DeployStatus = Literal["live", "publishing"]
-#: ``"building"`` while the agent's code is brought up (a run started with
-#: ``server_id``), ``"fixing"`` while the agent works on the brief, then
-#: ``"reported"`` or ``"failed"``.
-TuningStatus = Literal["building", "fixing", "reported", "failed"]
 
 # A task poll stops here: nothing further happens without you (input) or it's over.
 TASK_TERMINAL_STATES = frozenset({"completed", "failed", "cancelled", "awaiting_input"})
 BUILD_TERMINAL_STATES = frozenset({"completed"})
-TUNING_TERMINAL_STATES = frozenset({"reported", "failed"})
 
 WEBHOOK_EVENTS = (
     "task.created",
@@ -59,8 +55,6 @@ WEBHOOK_EVENTS = (
     "quota.threshold",
     "quota.cap_reached",
     "quota.egress_cap_reached",
-    "tuning.started",
-    "tuning.completed",
 )
 
 
@@ -477,40 +471,6 @@ class ProjectImport(Generic[P]):
         )
 
 
-@dataclass
-class TuningStart(Generic[P]):
-    """What ``tuning.start()`` answered.
-
-    Starting twice for one proposal never starts a second agent: the API hands
-    back the run already under way, with ``started`` False and a ``message``.
-    """
-    session: P
-    #: False when a run already existed for this proposal and ``session`` is it.
-    started: bool
-    message: Optional[str] = None
-    #: False when the brief was issued before the platform finished its
-    #: analysis, so it carries per-case judgements but no summarised diagnosis.
-    analysis_ready: Optional[bool] = None
-    #: Set when the run started but the evaluation platform could not be told.
-    #: The run is unaffected; the next status report retries.
-    warning: Optional[str] = None
-    #: Set when this call built the agent's code into a new project
-    #: (``server_id``): ``projectId``, ``source`` and ``envKeys``.
-    built: Optional[dict] = None
-
-    @staticmethod
-    def parse(session: Any, raw: dict) -> "TuningStart[Any]":
-        return TuningStart(
-            session=session,
-            # The API answers an existing run with a message and a new one without.
-            started="message" not in raw,
-            message=raw.get("message"),
-            analysis_ready=raw.get("analysisReady", raw.get("analysis_ready")),
-            warning=raw.get("warning"),
-            built=raw.get("built"),
-        )
-
-
 # --- request-body helpers ------------------------------------------------------
 
 def secret_inputs(secrets: SecretsArg) -> List[dict]:
@@ -584,8 +544,7 @@ def parse_project(raw: dict) -> Dict[str, Any]:
 
 def parse_task(raw: dict) -> Dict[str, Any]:
     return dict(
-        # A tuning session's run arrives in the run shape, keyed run_id.
-        id=raw["id"] if "id" in raw else raw["run_id"],
+        id=raw["id"],
         server_id=raw.get("serverId", raw.get("server_id")),
         project_id=raw.get("projectId", raw.get("project_id")),
         goal=raw["goal"],
@@ -613,26 +572,3 @@ def parse_build(raw: dict) -> Dict[str, Any]:
         url=raw.get("url"),
         created_at=raw.get("createdAt", raw.get("created_at")),
     )
-
-
-def parse_tuning_session(raw: dict) -> Dict[str, Any]:
-    return dict(
-        id=raw["id"],
-        server_id=raw.get("serverId", raw.get("server_id")),
-        project_id=raw.get("projectId", raw.get("project_id")),
-        run_id=raw.get("runId", raw.get("run_id")),
-        build_run_id=raw.get("buildRunId", raw.get("build_run_id")),
-        proposal_id=raw.get("proposalId", raw.get("proposal_id")),
-        evaluation_api_base=raw.get("evaluationApiBase", raw.get("evaluation_api_base")),
-        key_secret=raw.get("keySecretKey", raw.get("key_secret")),
-        brief_path=raw.get("briefPath", raw.get("brief_path")),
-        brief_revision=raw.get("briefRevision", raw.get("brief_revision")),
-        status=raw["status"],
-        change_summary=raw.get("changeSummary", raw.get("change_summary")),
-        changed_files=raw.get("changedFiles", raw.get("changed_files")) or [],
-        deployment_url=raw.get("deploymentUrl", raw.get("deployment_url")),
-        reported_at=raw.get("reportedAt", raw.get("reported_at")),
-        report_error=raw.get("reportError", raw.get("report_error")),
-        created_at=raw.get("createdAt", raw.get("created_at")),
-        updated_at=raw.get("updatedAt", raw.get("updated_at")),
-    )

{server4agent-0.7.0 → server4agent-0.9.0}/server4agent/_sync/client.py

@@ -26,9 +26,6 @@ from .._models import (
     ServerKind,
     ServerTier,
     TASK_TERMINAL_STATES,
-    TUNING_TERMINAL_STATES,
-    TuningStart,
-    TuningStatus,
     Webhook,
     _Record,
     bundle_b64,
@@ -36,7 +33,6 @@ from .._models import (
     parse_project,
     parse_server,
     parse_task,
-    parse_tuning_session,
     secret_inputs,
 )
 from .._transport import quote_segment as _seg
@@ -193,11 +189,15 @@ class Project(_Record):
         description: Optional[str] = None,
         visibility: Optional[str] = None,
         access: Optional[str] = None,
+        access_password: Optional[str] = None,
         lifecycle: Optional[str] = None,
         run_plan: Optional[Mapping[str, Any]] = None,
     ) -> "Project":
         """``run_plan`` replaces the stored plan wholesale and is recorded for the
-        next bring-up, not acted on: ``init()`` is how you ask for the rebuild."""
+        next bring-up, not acted on: ``init()`` is how you ask for the rebuild.
+        ``access_password`` sets or changes the password for ``access="password"``;
+        sent alone it changes the password and signs out everyone who used the
+        old one. It is never returned."""
         body = {
             k: v
             for k, v in {
@@ -205,6 +205,7 @@ class Project(_Record):
                 "description": description,
                 "visibility": visibility,
                 "access": access,
+                "access_password": access_password,
                 "lifecycle": lifecycle,
                 "run_plan": dict(run_plan) if run_plan is not None else None,
             }.items()
@@ -366,86 +367,6 @@ class Build(_Record):
         return self
 
 
-class TuningSession(_Record):
-    """A run that fixes an agent from an evaluation platform's report.
-
-    Reading it is what advances it: each ``refresh()`` checks the agent run
-    behind it, and the first one after that run finishes reports the outcome
-    back to the platform. ``wait()`` polls until it is reported or failed.
-    """
-    id: str
-    server_id: str
-    project_id: str
-    #: The agent run doing the fixing (a task on the server). None while building.
-    run_id: Optional[str]
-    #: The bring-up run, when this session built the project from the agent's source.
-    build_run_id: Optional[str]
-    proposal_id: str
-    evaluation_api_base: str
-    #: Name of the secret holding the evaluation API key, never its value.
-    key_secret: str
-    brief_path: Optional[str]
-    brief_revision: Optional[str]
-    status: str
-    change_summary: Optional[str]
-    changed_files: List[str]
-    deployment_url: Optional[str]
-    reported_at: Optional[str]
-    #: Why the last report to the platform failed. The next read retries.
-    report_error: Optional[str]
-    created_at: str
-    updated_at: str
-    #: The agent run behind the session, as of the last ``get()`` or ``refresh()``.
-    run: Optional["Task"]
-
-    def __init__(self, transport: SyncTransport, raw: dict, run: Optional[dict] = None) -> None:
-        self._t = transport
-        self.__dict__.update(parse_tuning_session(raw))
-        self.run = Task(transport, run) if run else None
-
-    def refresh(self) -> "TuningSession":
-        r = self._t.request("GET", f"/tuning/sessions/{_seg(self.id)}")
-        self.__dict__.update(parse_tuning_session(r["session"]))
-        self.run = Task(self._t, r["run"]) if r.get("run") else None
-        return self
-
-    def wait(
-        self,
-        *,
-        poll_interval: float = 2.0,
-        timeout: float = 1800.0,
-        on_poll: Optional[Callable[["TuningSession"], None]] = None,
-    ) -> "TuningSession":
-        """Block until the session is ``reported`` or ``failed``. Raises
-        ``APITimeoutError`` if ``timeout`` elapses first.
-
-        ``on_poll`` is called with ``self`` after each refresh."""
-        deadline = time.monotonic() + timeout
-        while self.status not in TUNING_TERMINAL_STATES:
-            if time.monotonic() >= deadline:
-                raise APITimeoutError(f"Tuning session {self.id} still {self.status!r} after {timeout}s.")
-            time.sleep(poll_interval)
-            self.refresh()
-            if on_poll is not None:
-                on_poll(self)
-        return self
-
-    def report(
-        self,
-        *,
-        change_summary: Optional[str] = None,
-        changed_files: Optional[Sequence[str]] = None,
-        deployment_url: Optional[str] = None,
-        failed: Optional[bool] = None,
-    ) -> "TuningSession":
-        """Send your own account of the fix to the evaluation platform, rather
-        than letting it be read off the run's final message. ``failed=True``
-        closes the run as failed."""
-        r = _report_tuning(self._t, self.id, change_summary, changed_files, deployment_url, failed)
-        self.__dict__.update(parse_tuning_session(r["session"]))
-        return self
-
-
 # =============================================================================
 # Scoped sub-resources — reached via a Server handle (server.tasks, ...).
 # =============================================================================
@@ -466,6 +387,7 @@ class _ScopedProjects:
         description: Optional[str] = None,
         visibility: Optional[str] = None,
         access: Optional[str] = None,
+        access_password: Optional[str] = None,
         lifecycle: Optional[str] = None,
         template: Optional[str] = None,
         source: Optional[Mapping[str, Any]] = None,
@@ -483,6 +405,7 @@ class _ScopedProjects:
                 "description": description,
                 "visibility": visibility,
                 "access": access,
+                "access_password": access_password,
                 "lifecycle": lifecycle,
                 "template": template,
                 "source": dict(source) if source is not None else None,
@@ -662,27 +585,6 @@ def _logs(
     return LogsSnapshot.parse(r["logs"]) if r.get("logs") is not None else None
 
 
-def _report_tuning(
-    t: SyncTransport,
-    session_id: str,
-    change_summary: Optional[str],
-    changed_files: Optional[Sequence[str]],
-    deployment_url: Optional[str],
-    failed: Optional[bool],
-) -> dict:
-    body = {
-        k: v
-        for k, v in {
-            "change_summary": change_summary,
-            "changed_files": list(changed_files) if changed_files is not None else None,
-            "deployment_url": deployment_url,
-            "failed": failed,
-        }.items()
-        if v is not None
-    }
-    return t.request("PATCH", f"/tuning/sessions/{_seg(session_id)}", body=body)
-
-
 # =============================================================================
 # Top-level resources — the flat client.servers.* API.
 # =============================================================================
@@ -909,68 +811,6 @@ class SecretsResource:
         return _ScopedSecrets(self._t, f"/projects/{_seg(project_id)}/secrets").set(secrets)
 
 
-class TuningResource:
-    """Tuning runs: fix an agent from an evaluation platform's report, then
-    report back what changed so the platform can score the fixed agent."""
-
-    def __init__(self, transport: SyncTransport) -> None:
-        self._t = transport
-
-    def list(
-        self, *, project_id: Optional[str] = None, status: Optional[TuningStatus] = None
-    ) -> List[TuningSession]:
-        """Newest first."""
-        r = self._t.request("GET", "/tuning/sessions", query={"project_id": project_id, "status": status})
-        return [TuningSession(self._t, s) for s in r["sessions"]]
-
-    def start(
-        self,
-        proposal_id: str,
-        *,
-        project_id: Optional[str] = None,
-        server_id: Optional[str] = None,
-        evaluation_api_base: Optional[str] = None,
-        key_secret: Optional[str] = None,
-    ) -> TuningStart[TuningSession]:
-        """Start fixing the agent behind an improvement proposal.
-
-        Pass ``project_id`` when the agent's code is already a project here, or
-        ``server_id`` to build it into a new project on that server first. The
-        evaluation API key is read from the secret named ``key_secret``
-        (``AGENTX_API_KEY`` unless you name another); a scoped key may not set
-        ``key_secret`` or ``evaluation_api_base``."""
-        body = {
-            k: v
-            for k, v in {
-                "proposal_id": proposal_id,
-                "project_id": project_id,
-                "server_id": server_id,
-                "evaluation_api_base": evaluation_api_base,
-                "key_secret": key_secret,
-            }.items()
-            if v is not None
-        }
-        r = self._t.request("POST", "/tuning/sessions", body=body)
-        return TuningStart.parse(TuningSession(self._t, r["session"]), r)
-
-    def get(self, tuning_session_id: str) -> TuningSession:
-        """Read a session, which also advances it (see ``TuningSession``)."""
-        r = self._t.request("GET", f"/tuning/sessions/{_seg(tuning_session_id)}")
-        return TuningSession(self._t, r["session"], r.get("run"))
-
-    def report(
-        self,
-        tuning_session_id: str,
-        *,
-        change_summary: Optional[str] = None,
-        changed_files: Optional[Sequence[str]] = None,
-        deployment_url: Optional[str] = None,
-        failed: Optional[bool] = None,
-    ) -> TuningSession:
-        r = _report_tuning(self._t, tuning_session_id, change_summary, changed_files, deployment_url, failed)
-        return TuningSession(self._t, r["session"])
-
-
 class KeysResource:
     def __init__(self, transport: SyncTransport) -> None:
         self._t = transport
@@ -1061,7 +901,6 @@ class Server4Agent:
         self.builds = BuildsResource(self._t)
         self.files = FilesResource(self._t)
         self.secrets = SecretsResource(self._t)
-        self.tuning = TuningResource(self._t)
         self.keys = KeysResource(self._t)
         self.webhooks = WebhooksResource(self._t)
 

server4agent-0.9.0/server4agent/_version.py

@@ -0,0 +1 @@
+__version__ = "0.9.0"

{server4agent-0.7.0 → server4agent-0.9.0}/tests/test_client.py

@@ -24,7 +24,6 @@ from server4agent import (
     Server,
     Server4Agent,
     Server4AgentError,
-    TuningStart,
     WEBHOOK_EVENTS,
 )
 from server4agent._sync.client import (
@@ -804,97 +803,6 @@ def test_me(api):
     assert me.authenticated_key == {"id": "key_1", "label": "ci"}
 
 
-# --- tuning -------------------------------------------------------------------
-
-def _tuning_raw(**over):
-    base = {
-        "id": "tun_1", "serverId": "srv_1", "projectId": "prj_1", "runId": "tsk_5",
-        "buildRunId": None, "proposalId": "prop_1",
-        "evaluationApiBase": "https://api.evals.example", "keySecretKey": "EVAL_API_KEY",
-        "briefPath": ".tuning/brief.md", "briefRevision": "r1", "status": "fixing",
-        "changeSummary": None, "changedFiles": [], "deploymentUrl": None,
-        "reportedAt": None, "reportError": None,
-        "createdAt": "2026-10-11T00:00:00Z", "updatedAt": "2026-10-11T00:00:00Z",
-    }
-    base.update(over)
-    return base
-
-
-def test_tuning_list_with_filters(api):
-    c = api.client(_routes({("GET", "/tuning/sessions"): (200, {"sessions": [_tuning_raw()]})}))
-    sessions = api.call(c.tuning.list(project_id="prj_1", status="fixing"))
-    assert api.last["query"] == {"project_id": "prj_1", "status": "fixing"}
-    s = sessions[0]
-    assert (s.id, s.server_id, s.project_id, s.run_id, s.proposal_id) == ("tun_1", "srv_1", "prj_1", "tsk_5", "prop_1")
-    assert (s.key_secret, s.evaluation_api_base, s.status) == ("EVAL_API_KEY", "https://api.evals.example", "fixing")
-    assert s.run is None
-
-    api.call(c.tuning.list())
-    assert api.last["query"] == {}
-
-
-def test_tuning_start_new_and_already_running(api):
-    responses = iter([
-        (201, {"session": _tuning_raw(), "analysisReady": False, "warning": "platform not told"}),
-        (200, {"session": _tuning_raw(), "message": "A tuning run already exists for this proposal."}),
-    ])
-
-    def handler(req):
-        status, body = next(responses)
-        return httpx.Response(status, json=body)
-
-    c = api.client(handler)
-    first = api.call(c.tuning.start("prop_1", project_id="prj_1", key_secret="EVAL_API_KEY"))
-    assert api.last["method"] == "POST" and api.last["path"] == "/tuning/sessions"
-    assert api.last["body"] == {"proposal_id": "prop_1", "project_id": "prj_1", "key_secret": "EVAL_API_KEY"}
-    assert isinstance(first, TuningStart)
-    assert first.started is True and first.analysis_ready is False and first.warning == "platform not told"
-    assert first.session.id == "tun_1"
-
-    again = api.call(c.tuning.start("prop_1", server_id="srv_1"))
-    assert api.last["body"] == {"proposal_id": "prop_1", "server_id": "srv_1"}
-    assert again.started is False and again.message.startswith("A tuning run already exists")
-
-
-def test_tuning_get_carries_the_run_and_wait_polls_to_reported(api):
-    run = {  # the run arrives in the run shape, keyed run_id
-        "run_id": "tsk_5", "server_id": "srv_1", "project_id": "prj_1", "goal": "Fix the agent",
-        "message_type": "system", "status": "running", "created_at": "t", "log": "reading brief",
-        "result": None, "question": None, "change": None, "usage": None,
-    }
-    states = iter(["fixing", "reported"])
-
-    def handler(req):
-        return httpx.Response(200, json={"session": _tuning_raw(status=next(states)), "run": run})
-
-    c = api.client(handler)
-    s = api.call(c.tuning.get(HOSTILE))
-    assert api.last["path"] == f"/tuning/sessions/{HOSTILE_SEG}"
-    assert s.status == "fixing"
-    assert (s.run.id, s.run.server_id, s.run.project_id, s.run.log) == ("tsk_5", "srv_1", "prj_1", "reading brief")
-
-    polled = []
-    done = api.call(s.wait(poll_interval=0, on_poll=lambda x: polled.append(x.status)))
-    assert done.status == "reported" and polled == ["reported"]
-
-
-def test_tuning_report(api):
-    reported = _tuning_raw(status="reported", changeSummary="Grounded answers in the docs", changedFiles=["agent.py"])
-    c = api.client(_routes({
-        ("PATCH", f"/tuning/sessions/{HOSTILE_SEG}"): (200, {"session": reported}),
-        ("GET", "/tuning/sessions"): (200, {"sessions": [_tuning_raw(id=HOSTILE)]}),
-    }))
-    s = api.call(c.tuning.report(HOSTILE, change_summary="Grounded answers in the docs", changed_files=("agent.py",)))
-    assert api.last["method"] == "PATCH"
-    assert api.last["body"] == {"change_summary": "Grounded answers in the docs", "changed_files": ["agent.py"]}
-    assert s.status == "reported" and s.changed_files == ["agent.py"]
-
-    handle = api.call(c.tuning.list())[0]
-    api.call(handle.report(failed=True))
-    assert api.last["body"] == {"failed": True}
-    assert handle.status == "reported"
-
-
 # --- drift fixed in existing methods ------------------------------------------
 
 def test_deployments_parse_with_project_id(api):
@@ -947,7 +855,8 @@ def test_webhooks_create_without_events_omits_them(api):
     })}))
     api.call(c.webhooks.create("https://hooks.northstar.example/s4a"))
     assert api.last["body"] == {"url": "https://hooks.northstar.example/s4a"}
-    assert "tuning.completed" in WEBHOOK_EVENTS and "quota.egress_cap_reached" in WEBHOOK_EVENTS
+    assert "quota.egress_cap_reached" in WEBHOOK_EVENTS
+    assert "tuning.started" not in WEBHOOK_EVENTS and "tuning.completed" not in WEBHOOK_EVENTS
 
 
 def test_exec_in_a_project_folder(api):
@@ -1028,6 +937,22 @@ def test_project_update_run_plan_and_refresh_keeps_init_run_id(api):
     assert project.init_run_id == "tsk_3"  # only the create response carries it
 
 
+def test_project_access_password_goes_out_as_access_password(api):
+    c = api.client(_routes({
+        ("POST", "/servers/srv_1/projects"): (201, _project_raw(access="password")),
+        ("PATCH", "/projects/prj_1"): (200, _project_raw(access="password")),
+    }))
+    project = api.call(c.projects.create(
+        "srv_1", name="web", access="password", access_password="correct horse battery",
+    ))
+    assert api.last["body"] == {
+        "name": "web", "access": "password", "access_password": "correct horse battery",
+    }
+    assert project.access == "password"
+    api.call(project.update(access_password="a new passphrase"))
+    assert api.last["method"] == "PATCH" and api.last["body"] == {"access_password": "a new passphrase"}
+
+
 def test_template_source_kind_and_failed_build_steps(api):
     c = api.client(_routes({
         ("GET", "/templates"): (200, {"templates": [{

server4agent-0.7.0/server4agent/_version.py

@@ -1 +0,0 @@
-__version__ = "0.7.0"