mirasoth-agentspace 0.1.0__py3-none-any.whl

agentspace/__init__.py

@@ -0,0 +1,118 @@
+"""agentspace — Python SDK and CLI for the Mirasoth AgentSpace API.
+
+Distributed as ``mirasoth-agentspace`` on PyPI; imported as ``agentspace``.
+Standalone cloud service providing isolated workspaces for agent
+execution: workspace/file CRUD, streaming agent sessions (SSE), one-shot
+tasks, semantic memory search — pure stdlib, zero runtime dependencies.
+
+Quickstart::
+
+    from agentspace import AgentSpace
+
+    api = AgentSpace("http://127.0.0.1:8620", "asp_...")
+    ws = api.create_workspace("demo")
+    api.upload_file(ws.id, "docs/brief.md", b"# brief")
+
+    ses = api.create_session(ws.id, "main")
+    reply = api.run_turn(ws.id, ses.id, "Read docs/brief.md and summarize it.")
+
+The package also installs an ``agentspace`` console script (see
+:mod:`agentspace.cli`).
+"""
+
+from .client import (
+    DEFAULT_TIMEOUT,
+    AgentSpace,
+    AgentSpaceClient,
+    HTTPResponse,
+    SessionHandle,
+    TaskHandle,
+    Transport,
+    UrllibTransport,
+    WorkspaceHandle,
+)
+from .errors import (
+    AgentSpaceError,
+    APIError,
+    BadRequestError,
+    ConflictError,
+    ForbiddenError,
+    NotFoundError,
+    RateLimitError,
+    ServerError,
+    TransportError,
+    TurnError,
+    UnauthorizedError,
+)
+from .models import (
+    TASK_TERMINAL_STATUSES,
+    ApiKey,
+    ApiKeyCreated,
+    ApiKeyList,
+    FileEntry,
+    FileEntryList,
+    Identity,
+    ImageAttachment,
+    Session,
+    SessionList,
+    SessionMessage,
+    SessionMessageList,
+    Task,
+    TaskList,
+    TurnAccepted,
+    TurnHints,
+    Workspace,
+    WorkspaceList,
+)
+from .sse import StreamEvent, parse_error_payload, parse_sse_stream
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "__version__",
+    # client
+    "AgentSpace",
+    "AgentSpaceClient",
+    "WorkspaceHandle",
+    "SessionHandle",
+    "TaskHandle",
+    "Transport",
+    "UrllibTransport",
+    "HTTPResponse",
+    "DEFAULT_TIMEOUT",
+    # errors
+    "AgentSpaceError",
+    "APIError",
+    "BadRequestError",
+    "UnauthorizedError",
+    "ForbiddenError",
+    "NotFoundError",
+    "ConflictError",
+    "RateLimitError",
+    "ServerError",
+    "TransportError",
+    "TurnError",
+    # models
+    "Identity",
+    "Workspace",
+    "WorkspaceList",
+    "FileEntry",
+    "FileEntryList",
+    "Session",
+    "SessionList",
+    "SessionMessage",
+    "SessionMessageList",
+    "TurnAccepted",
+    "TurnHints",
+    "Task",
+    "TaskList",
+    "TASK_TERMINAL_STATUSES",
+    "ApiKey",
+    "ApiKeyCreated",
+    "ApiKeyList",
+    "ImageAttachment",
+    # sse
+    "StreamEvent",
+    "parse_sse_stream",
+    "parse_error_payload",
+]

agentspace/__main__.py

@@ -0,0 +1,8 @@
+"""``python -m agentspace`` — delegates to the ``agentspace`` CLI."""
+
+import sys
+
+from .cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())

agentspace/_config.py

@@ -0,0 +1,57 @@
+"""CLI credential storage, file-compatible with the Go CLI.
+
+The Go CLI (``cmd/agentspace``) and this Python CLI share the same config
+file (``~/.agentspace/config.json`` with ``{"url": ..., "apiKey": ...}``)
+and the same environment variables (``AGENTSPACE_URL`` /
+``AGENTSPACE_API_KEY``), so either CLI can pick up where the other left
+off. Environment variables always win over the file.
+"""
+
+from __future__ import annotations
+
+import json
+import os
+from pathlib import Path
+from typing import Tuple
+
+ENV_URL = "AGENTSPACE_URL"
+ENV_API_KEY = "AGENTSPACE_API_KEY"
+ENV_CONFIG = "AGENTSPACE_CONFIG"
+
+
+def config_file() -> Path:
+    """Location of the shared CLI config file."""
+    override = os.environ.get(ENV_CONFIG)
+    if override:
+        return Path(override)
+    return Path.home() / ".agentspace" / "config.json"
+
+
+def load_config() -> Tuple[str, str]:
+    """Resolve credentials: env vars win over the config file. May be empty."""
+    stored: dict = {}
+    path = config_file()
+    try:
+        stored = json.loads(path.read_text(encoding="utf-8"))
+        if not isinstance(stored, dict):
+            stored = {}
+    except (OSError, ValueError):
+        stored = {}
+    url = os.environ.get(ENV_URL, "") or str(stored.get("url") or "")
+    api_key = os.environ.get(ENV_API_KEY, "") or str(stored.get("apiKey") or "")
+    return url, api_key
+
+
+def save_config(url: str, api_key: str) -> Path:
+    """Persist credentials to the shared config file (created 0600)."""
+    path = config_file()
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_text(
+        json.dumps({"url": url, "apiKey": api_key}, indent=2) + "\n",
+        encoding="utf-8",
+    )
+    try:
+        path.chmod(0o600)
+    except OSError:
+        pass  # e.g. some filesystems ignore POSIX modes
+    return path