codemie-sdk-python 0.1.689__py3-none-any.whl → 0.1.691__py3-none-any.whl

codemie_sdk/client/client.py

@@ -18,6 +18,7 @@ from ..services.skill import SkillService
 from ..services.task import TaskService
 from ..services.user import UserService
 from ..services.workflow import WorkflowService
+from ..services.workspace import WorkspaceService
 from ..services.files import FileOperationService
 from ..services.webhook import WebhookService
 from ..services.vendor_assistant import VendorAssistantService
@@ -185,6 +186,9 @@ class CodeMieClient:
         self.a2a = A2AService(
             self._api_domain, _token_source, verify_ssl=self._verify_ssl
         )
+        self.workspaces = WorkspaceService(
+            self._api_domain, _token_source, verify_ssl=self._verify_ssl
+        )
 
     @property
     def token(self) -> str:

codemie_sdk/models/project.py

@@ -176,6 +176,24 @@ class ProjectUpdateRequest(BaseModel):
     chargeback_attribution: str | None = None
 
 
+class ProjectOwnershipUpdateRequest(BaseModel):
+    """Request to transfer project ownership to another user."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    user_id: str
+
+
+class ProjectOwnershipUpdateResponse(BaseModel):
+    """Response after transferring project ownership."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    name: str
+    created_by: str
+    message: str
+
+
 class ProjectDeleteResponse(BaseModel):
     """Response after deleting a project."""
 

codemie_sdk/models/skill.py

@@ -45,6 +45,23 @@ class SkillBase(BaseModel):
     mcp_servers: list[MCPServerDetails] = Field(default_factory=list)
 
 
+class SkillCompanionFileMetadata(BaseModel):
+    """Metadata of a companion (bundle) file stored alongside a skill."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    path: str
+    mime_type: str = "text/plain"
+    encoding: str = "text"
+    size_bytes: int = 0
+
+
+class SkillCompanionFilePayload(SkillCompanionFileMetadata):
+    """Companion file sent on skill create/update, or returned with its content."""
+
+    content: str
+
+
 class SkillListResponse(SkillBase):
     """Skill list item response."""
 
@@ -61,6 +78,8 @@ class SkillDetailResponse(SkillListResponse):
     content: str
     slug: str | None = None
     icon_url: str | None = Field(None, alias="iconUrl")
+    companion_files: list[SkillCompanionFileMetadata] = Field(default_factory=list)
+    bundle_warning: str | None = None
 
 
 class SkillCreateRequest(BaseModel):
@@ -74,6 +93,7 @@ class SkillCreateRequest(BaseModel):
     categories: list[str] | None = Field(default_factory=list)
     enabled_builtin_subagents: list[str] | None = None
     mcp_servers: list[MCPServerDetails] | None = Field(default_factory=list)
+    companion_files: list[SkillCompanionFilePayload] | None = None
 
 
 class SkillUpdateRequest(BaseModel):
@@ -87,6 +107,7 @@ class SkillUpdateRequest(BaseModel):
     categories: list[str] | None = None
     enabled_builtin_subagents: list[str] | None = None
     mcp_servers: list[MCPServerDetails] | None = None
+    companion_files: list[SkillCompanionFilePayload] | None = None
 
 
 class SkillImportRequest(BaseModel):
@@ -227,3 +248,6 @@ class SkillConfigResponse(BaseModel):
 
     max_content_length: int
     min_content_length: int
+    bundle_seed_max_file_count: int | None = None
+    bundle_seed_max_file_size_bytes: int | None = None
+    bundle_seed_max_total_size_bytes: int | None = None

codemie_sdk/models/workspace.py

@@ -0,0 +1,57 @@
+"""Models for agent workspace data structures."""
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class Workspace(BaseModel):
+    """Agent workspace that belongs to one conversation (or workflow execution)."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    id: str
+    conversation_id: str
+    user_id: str | None = None
+    name: str | None = None
+    status: str | None = None
+
+
+class WorkspaceFileItem(BaseModel):
+    """One file listed in a workspace."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    path: str
+    mime_type: str | None = None
+    checksum: str | None = None
+    size: int | None = None
+    version: int | None = None
+
+
+class WorkspaceFileContent(WorkspaceFileItem):
+    """A workspace file with its content (text, or base64 for images)."""
+
+    is_binary: bool = False
+    content: str | None = None
+    content_encoding: str | None = None
+
+
+class WorkspaceDeleteFileResponse(BaseModel):
+    """Result of deleting a workspace file."""
+
+    model_config = ConfigDict(extra="ignore")
+
+    message: str
+    deleted: bool
+
+
+class ExecuteWorkspaceScriptResponse(BaseModel):
+    """Result of running a script stored in a workspace."""
+
+    model_config = ConfigDict(extra="ignore", populate_by_name=True)
+
+    message: str
+    output: str
+    workspace_files: list[WorkspaceFileItem] = Field(
+        default_factory=list, alias="workspaceFiles"
+    )
+    warnings: list[str] = Field(default_factory=list)

codemie_sdk/services/project.py

@@ -30,6 +30,8 @@ from ..models.project import (
     ProjectCreateResponse,
     ProjectDeleteResponse,
     ProjectDetailResponse,
+    ProjectOwnershipUpdateRequest,
+    ProjectOwnershipUpdateResponse,
     ProjectUpdateRequest,
     ProjectUpdateResponse,
 )
@@ -217,6 +219,33 @@ class ProjectService:
             response_model=ProjectDeleteResponse,
         )
 
+    def transfer_ownership(
+        self,
+        project_name: str,
+        user_id: str,
+    ) -> ProjectOwnershipUpdateResponse:
+        """Transfer ownership of a project to another active user.
+
+        Args:
+            project_name: Project name
+            user_id: ID of the user who becomes the new owner
+
+        Returns:
+            ProjectOwnershipUpdateResponse with the project name, new owner id and message
+
+        Raises:
+            HTTPException: 404 if the project or the target user is not found, or the
+                caller may not manage the project; 403 if the project is personal
+        """
+        payload = ProjectOwnershipUpdateRequest(user_id=user_id)
+
+        return self._api.put(
+            f"/v1/projects/{project_name}/ownership",
+            response_model=ProjectOwnershipUpdateResponse,
+            json_data=payload.model_dump(),
+            wrap_response=False,
+        )
+
     # Assignment endpoints
 
     def assign_user_to_project(

codemie_sdk/services/skill.py

@@ -9,6 +9,8 @@ from ..models.skill import (
     SkillAttachRequest,
     SkillBulkAttachRequest,
     SkillCategory,
+    SkillCompanionFileMetadata,
+    SkillCompanionFilePayload,
     SkillConfigResponse,
     SkillCreateRequest,
     SkillDetailResponse,
@@ -116,6 +118,38 @@ class SkillService:
         """
         return self._api.delete(f"/v1/skills/{skill_id}", dict)
 
+    # Companion (bundle) files
+
+    def list_companion_files(self, skill_id: str) -> list[SkillCompanionFileMetadata]:
+        """List the metadata of a skill's bundled companion files.
+
+        Args:
+            skill_id: Skill identifier
+
+        Returns:
+            Companion file metadata (path, mime type, encoding, size), without content
+        """
+        return self._api.get(
+            f"/v1/skills/{skill_id}/companion-files",
+            list[SkillCompanionFileMetadata],
+        )
+
+    def get_companion_file(self, skill_id: str, path: str) -> SkillCompanionFilePayload:
+        """Get one companion file of a skill, with its content, by its relative path.
+
+        Args:
+            skill_id: Skill identifier
+            path: Relative companion file path, e.g. ``references/guide.md``
+
+        Returns:
+            The companion file including its stored content
+        """
+        return self._api.get(
+            f"/v1/skills/{skill_id}/companion-files/content",
+            SkillCompanionFilePayload,
+            params={"path": path},
+        )
+
     # Import/Export Operations
 
     def import_skill(self, request: SkillImportRequest) -> SkillDetailResponse:
@@ -391,10 +425,11 @@ class SkillService:
         )
 
     def get_config(self) -> SkillConfigResponse:
-        """Get effective skill content-length limits.
+        """Get effective skill content-length and bundle-seed limits.
 
         Returns:
-            Skill config with max_content_length and min_content_length
+            Skill config with max_content_length, min_content_length and the
+            bundle_seed_max_* ceilings applied when skill files are placed in a workspace
         """
         return self._api.get("/v1/skills/config", SkillConfigResponse)
 

codemie_sdk/services/workspace.py

@@ -0,0 +1,160 @@
+"""Agent workspace service implementation."""
+
+from __future__ import annotations
+
+from ..models.workspace import (
+    ExecuteWorkspaceScriptResponse,
+    Workspace,
+    WorkspaceDeleteFileResponse,
+    WorkspaceFileContent,
+    WorkspaceFileItem,
+)
+from ..utils.http import ApiRequestHandler, TokenSource
+
+
+class WorkspaceService:
+    """Service for the files of agent workspaces (one workspace per conversation)."""
+
+    def __init__(self, api_domain: str, token: TokenSource, verify_ssl: bool = True):
+        """Initialize the workspace service.
+
+        Args:
+            api_domain: Base URL for the CodeMie API
+            token: Authentication token
+            verify_ssl: Whether to verify SSL certificates. Default: True
+        """
+        self._api = ApiRequestHandler(api_domain, token, verify_ssl)
+
+    def create(self, conversation_id: str, name: str | None = None) -> Workspace:
+        """Create the workspace of a conversation, or return the existing one.
+
+        Args:
+            conversation_id: Conversation (or workflow execution) identifier
+            name: Optional display name
+
+        Returns:
+            The workspace of the conversation
+        """
+        return self._api.post(
+            "/v1/workspaces",
+            Workspace,
+            json_data={"conversation_id": conversation_id, "name": name},
+        )
+
+    def get_by_conversation(self, conversation_id: str) -> Workspace:
+        """Get the workspace of a conversation.
+
+        Args:
+            conversation_id: Conversation (or workflow execution) identifier
+
+        Returns:
+            The workspace of the conversation
+
+        Raises:
+            requests.HTTPError: 400 when the conversation has no workspace
+        """
+        return self._api.get(
+            f"/v1/workspaces/conversations/{conversation_id}", Workspace
+        )
+
+    def list_files(
+        self, workspace_id: str, glob: str | None = None
+    ) -> list[WorkspaceFileItem]:
+        """List the files of a workspace.
+
+        Args:
+            workspace_id: Workspace identifier
+            glob: Optional glob filter on the file path
+
+        Returns:
+            Files currently in the workspace (deleted files are not listed)
+        """
+        return self._api.get(
+            f"/v1/workspaces/{workspace_id}/files",
+            list[WorkspaceFileItem],
+            params={"glob": glob} if glob else None,
+        )
+
+    def write_file(
+        self, workspace_id: str, file_path: str, content: str
+    ) -> WorkspaceFileItem:
+        """Create or overwrite a text file in a workspace.
+
+        Args:
+            workspace_id: Workspace identifier
+            file_path: Workspace-relative path
+            content: UTF-8 text content
+
+        Returns:
+            The written file
+
+        Raises:
+            requests.HTTPError: 400 when the path is invalid or reserved
+        """
+        return self._api.put(
+            f"/v1/workspaces/{workspace_id}/files",
+            WorkspaceFileItem,
+            json_data={"file_path": file_path, "content": content},
+        )
+
+    def read_file(self, workspace_id: str, file_path: str) -> WorkspaceFileContent:
+        """Read a file of a workspace.
+
+        Args:
+            workspace_id: Workspace identifier
+            file_path: Workspace-relative path
+
+        Returns:
+            The file with its content
+
+        Raises:
+            requests.HTTPError: 400 when the file does not exist
+        """
+        return self._api.get(
+            f"/v1/workspaces/{workspace_id}/files/content",
+            WorkspaceFileContent,
+            params={"file_path": file_path},
+        )
+
+    def delete_file(
+        self, workspace_id: str, file_path: str
+    ) -> WorkspaceDeleteFileResponse:
+        """Delete a file from a workspace (the file stays deleted for later requests).
+
+        Args:
+            workspace_id: Workspace identifier
+            file_path: Workspace-relative path
+
+        Returns:
+            Whether a file was deleted
+
+        Raises:
+            requests.HTTPError: 400 when the path is invalid or reserved
+        """
+        return self._api.delete(
+            f"/v1/workspaces/{workspace_id}/files",
+            WorkspaceDeleteFileResponse,
+            params={"file_path": file_path},
+        )
+
+    def execute_script(
+        self,
+        workspace_id: str,
+        script_path: str,
+        export_files: list[str] | None = None,
+    ) -> ExecuteWorkspaceScriptResponse:
+        """Run a Python script stored in a workspace.
+
+        Args:
+            workspace_id: Workspace identifier
+            script_path: Workspace-relative path of the script
+            export_files: Optional workspace files to export from the run
+
+        Returns:
+            Script output, exported files and warnings about skipped workspace files
+        """
+        return self._api.post(
+            f"/v1/workspaces/{workspace_id}/execute",
+            ExecuteWorkspaceScriptResponse,
+            json_data={"script_path": script_path, "export_files": export_files},
+        )

{codemie_sdk_python-0.1.689.dist-info → codemie_sdk_python-0.1.691.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: codemie-sdk-python
-Version: 0.1.689
+Version: 0.1.691
 Summary: CodeMie SDK for Python
 Author: Vadym Vlasenko
 Author-email: vadym_vlasenko@epam.com

{codemie_sdk_python-0.1.689.dist-info → codemie_sdk_python-0.1.691.dist-info}/RECORD

@@ -7,7 +7,7 @@ codemie_sdk/builders/workflow/builder.py,sha256=bb_1uUe0AFhWuqe60Dao_1E-INxPwa7b
 codemie_sdk/builders/workflow/definition.py,sha256=YsKFoYC_VdKsTO2_AobSduP-MGjImEddn_0W5HzPZHQ,14338
 codemie_sdk/builders/workflow/publish.py,sha256=wrXFDNX0LpRTULp8zm5DD6hEmAqEwIMxPm0mSs82xjQ,7370
 codemie_sdk/client/__init__.py,sha256=yf6C39MmrJ6gK9ZHMhBeynKwUUYVSUTQbKxU8-4qpKg,101
-codemie_sdk/client/client.py,sha256=d86R8eT_dwX2a4K0HKk4UfshHlTvuY9dMcQYZ0ztQX0,9593
+codemie_sdk/client/client.py,sha256=3v4uRF4SGGxR5Rs6fPQRbyysbKI_QEvrTB6wJH3MUN4,9770
 codemie_sdk/exceptions.py,sha256=uuzvtvYBMzrNGt7Q4k5RVq0Pd8eJ_tR2tLy3pF2ICDs,1148
 codemie_sdk/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 codemie_sdk/models/a2a.py,sha256=zCNLiwwg78rok04hMlGPcQQS1IbEV4OaMcA_1KxQ9xs,1588
@@ -27,8 +27,8 @@ codemie_sdk/models/integration.py,sha256=yBV28vZ8oN0oNRNHdDPL3UUSJqNga1YodABIfX8
 codemie_sdk/models/llm.py,sha256=ViADvsSAkc85YQyPUkGE3ZvMc5pnHWHO0_rOkLSTfu4,1333
 codemie_sdk/models/mcp_config.py,sha256=mvD2utb4fthjNGAIkZKEkTtHSQQyF2WEYrA7tn-e0Lo,2184
 codemie_sdk/models/mermaid.py,sha256=dhRgX-itvfyrt0LUg5pbSo0CTH5PewiegqcZn3hWggU,675
-codemie_sdk/models/project.py,sha256=_iE45WdlAufZIW0XyqwxExOhHhSVY-YLs--68phj5tQ,6983
-codemie_sdk/models/skill.py,sha256=JIVHubDlPL8tH62AQRL0nMd0vieN6MPGckj9Kuqp7RA,6068
+codemie_sdk/models/project.py,sha256=MWBWg_G373v8OHX_INqvZZg6TlRY0w8G_HDBqPa_CL0,7370
+codemie_sdk/models/skill.py,sha256=KE4lsF8TMxIQa_UE0oRDMT6XIEHqKjsDyi0HYKEp1mM,6918
 codemie_sdk/models/task.py,sha256=YHu5DRnECS2wnqIWZ_YH8Z72p1I4aV3xWFW5joxN_8Q,1442
 codemie_sdk/models/user.py,sha256=YqPWzTgIKF-7Jw6aV7RD__su1iahEJPGaDR6Px-B4bU,3848
 codemie_sdk/models/vendor_assistant.py,sha256=vdpFq8aRlLj7IgRMWTA6pkrq8HZty8rgwA-kWrKKf3A,6357
@@ -41,6 +41,7 @@ codemie_sdk/models/workflow_execution_payload.py,sha256=0nhbiXyZlvbhB2SB6B_T6s2b
 codemie_sdk/models/workflow_state.py,sha256=uP1yLYwPpgPc17xpLwjanvlRzK6zT9qMZR-fAkvwFGg,1322
 codemie_sdk/models/workflow_thoughts.py,sha256=9fE380lMvC23fq677EI_JTk48Nf2jyPg3-mpj9VTx54,579
 codemie_sdk/models/workflow_transition.py,sha256=axZeiwTo4wzEwZ5GuKphmlRpWmjIuKxV15P_4V1n7LQ,794
+codemie_sdk/models/workspace.py,sha256=xYnVO1Pnd0l0PSBe2pwP80C2ZvYBc2ESo6OH_G0cOOg,1438
 codemie_sdk/services/a2a.py,sha256=JI_heDKmQ1qYGIES_6qPosHRyVb73tKs4v7uTGpzXx4,1026
 codemie_sdk/services/activity_event.py,sha256=KoD0DyeqJ0CmQPA4PAXH4uGIAQCgcJbYwDnv-MCckGc,3630
 codemie_sdk/services/admin.py,sha256=yk1xdBXDjpdW4OMOdBaURkZhAxak9h-TppKyhStLekc,4006
@@ -58,9 +59,9 @@ codemie_sdk/services/integration.py,sha256=n4ggDedJ2GCI5mTgZNfrYE49uzLsp_BKYKMdT
 codemie_sdk/services/llm.py,sha256=GQWIi359f99uU4YRnAdpbyae1kXp1G5OpVgJNIIn7-8,1132
 codemie_sdk/services/mcp_configs.py,sha256=MrCiWJ6-ezXE9NOTgOfHDhfyQokaumGp1rwB4IAKXzs,2466
 codemie_sdk/services/mermaid.py,sha256=7cLykdrJVW576raUbON3yhuWnbGaXl8rX1QfVwbu2JE,2246
-codemie_sdk/services/project.py,sha256=ajs5ZEc7L9k6qJGjX28_LF6mrExC-uYvWhd3AuQBX_w,13309
+codemie_sdk/services/project.py,sha256=2O57E63mkt5Z-OwTksxiKplRDHwh6MV_COaztXO7j4A,14298
 codemie_sdk/services/project_budget_groups.py,sha256=B7QJt3sh_LV3lfwALZlxUq0SLR30BWafHcS6eHyOh8Y,5471
-codemie_sdk/services/skill.py,sha256=bwU21qGQFm85BdqkPeNJiWyzoyJL7SfEGmUs1XTyfks,11971
+codemie_sdk/services/skill.py,sha256=0mExdeKTMNqkEpKafD0ya1WyLj9CMCFaprkggKYqnQg,13216
 codemie_sdk/services/task.py,sha256=UaYh__xGF7VKWCJKPrncVjTvx46Gz1AN9XczPVL71oA,1052
 codemie_sdk/services/user.py,sha256=W0-fkY6vIbJDlIpb2PxxljSMOdWh910BmBK-n94gBs0,6998
 codemie_sdk/services/vendor_assistant.py,sha256=Vwa0rH8TYTCV1iAeKuSP5skbX8V04NLXE0g9VQRKqGI,13484
@@ -72,8 +73,9 @@ codemie_sdk/services/webhook.py,sha256=jYPEyJ0Q0IydMF9D2UoURsr6PgdfbKs4fr5L6ix8e
 codemie_sdk/services/workflow.py,sha256=D-20pUo6Lm3ef3WKTv-nwGMN1Dx5tmNwqeWCR0XcpoM,10439
 codemie_sdk/services/workflow_execution.py,sha256=GuI1uBtd1NGvRVHElMsgPBZlIRDP9CK73ISJABkpCs4,7225
 codemie_sdk/services/workflow_execution_state.py,sha256=u1xmGvaHjqvQS5ujhyvJ_Ac7ByjKem2Qe8q0swsmoWw,2045
+codemie_sdk/services/workspace.py,sha256=eLwZ0fhi1BfOesrXaQlTdOll8q7ENP9b_jb5eybKSVw,5038
 codemie_sdk/utils/__init__.py,sha256=EzK_UrS5KHmAnE73Hci9LaObB5omjVUhIq4svh0gfwo,137
 codemie_sdk/utils/http.py,sha256=PWejBKa5pwzQ5eLVhdN8lYKEu1B1QtwGTRmZfnGFL6c,14158
-codemie_sdk_python-0.1.689.dist-info/METADATA,sha256=WPbexxhcK0uQUzQGZYxprgICOcaYa_9j9GMDoqyca84,47441
-codemie_sdk_python-0.1.689.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-codemie_sdk_python-0.1.689.dist-info/RECORD,,
+codemie_sdk_python-0.1.691.dist-info/METADATA,sha256=5Ik4BOiQjqb5jMGCNjQ5pNYNJfoNzP1Ea64_l1EpWyY,47441
+codemie_sdk_python-0.1.691.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+codemie_sdk_python-0.1.691.dist-info/RECORD,,