codemie-sdk-python 0.1.689__tar.gz → 0.1.690__tar.gz

{codemie_sdk_python-0.1.689 → codemie_sdk_python-0.1.690}/PKG-INFO

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

{codemie_sdk_python-0.1.689 → codemie_sdk_python-0.1.690}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "codemie-sdk-python"
-version = "0.1.689"
+version = "0.1.690"
 description = "CodeMie SDK for Python"
 authors = [
     "Vadym Vlasenko <vadym_vlasenko@epam.com>",

{codemie_sdk_python-0.1.689 → codemie_sdk_python-0.1.690}/src/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_python-0.1.689 → codemie_sdk_python-0.1.690}/src/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_python-0.1.690/src/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_python-0.1.689 → codemie_sdk_python-0.1.690}/src/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_python-0.1.690/src/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},
+        )