convexity-sdk 0.15.0.dev289__tar.gz → 0.15.0.dev290__tar.gz

{convexity_sdk-0.15.0.dev289 → convexity_sdk-0.15.0.dev290}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: convexity-sdk
-Version: 0.15.0.dev289
+Version: 0.15.0.dev290
 Summary: Convexity Python SDK - programmatic access to the Convexity platform
 Requires-Python: >=3.12
 Requires-Dist: convexity-api-client

{convexity_sdk-0.15.0.dev289 → convexity_sdk-0.15.0.dev290}/convexity_sdk/resources/worker_tasks.py

@@ -3,6 +3,9 @@
 from __future__ import annotations
 
 from convexity_api_client import AuthenticatedClient, Client
+from convexity_api_client.api.v1 import (
+    worker_tasks_delegate_pi_agent as _worker_tasks_delegate_pi_agent,
+)
 from convexity_api_client.api.v1 import (
     worker_tasks_get as _worker_tasks_get,
 )
@@ -12,6 +15,7 @@ from convexity_api_client.api.v1 import (
 from convexity_api_client.api.v1 import (
     worker_tasks_trigger_analytics as _worker_tasks_trigger,
 )
+from convexity_api_client.models.delegate_pi_agent_request import DelegatePiAgentRequest
 from convexity_api_client.models.worker_task_response import WorkerTaskResponse
 from convexity_api_client.models.worker_task_status import WorkerTaskStatus
 from convexity_api_client.models.worker_task_type import WorkerTaskType
@@ -44,6 +48,50 @@ class WorkerTasks:
             raise RuntimeError(msg)
         return result
 
+    def delegate_pi_agent(
+        self,
+        project_id: str,
+        task_prompt: str,
+        *,
+        model: str = "deepseek-v4-pro",
+        max_steps: int = 40,
+        timeout_seconds: int = 900,
+        allow_network: bool = False,
+    ) -> WorkerTaskResponse:
+        """Delegate an agentic coding task to the Pi coding agent.
+
+        Enqueues a ``DELEGATE_PI_AGENT`` worker task; the agent runs in the
+        background worker process. Poll :meth:`get` for the final status and
+        output.
+
+        Args:
+            project_id: The project to run the task in.
+            task_prompt: Natural-language objective for the agent.
+            model: LLM model id for the agent.
+            max_steps: Hard cap on agent loop iterations.
+            timeout_seconds: Wall-clock budget for the session.
+            allow_network: Whether the sandbox may reach the network.
+
+        Returns:
+            The created WorkerTaskResponse (status=PENDING).
+        """
+        body = DelegatePiAgentRequest(
+            task_prompt=task_prompt,
+            model=model,
+            max_steps=max_steps,
+            timeout_seconds=timeout_seconds,
+            allow_network=allow_network,
+        )
+        result = _worker_tasks_delegate_pi_agent.sync(
+            client=self._client,
+            project_id=project_id,
+            body=body,
+        )
+        if not isinstance(result, WorkerTaskResponse):
+            msg = "Unexpected response delegating Pi agent task"
+            raise RuntimeError(msg)
+        return result
+
     def get(self, project_id: str, task_id: str) -> WorkerTaskResponse:
         """Get a worker task by ID.