squidcloud-client 1.0.483__tar.gz → 1.0.485__tar.gz

{squidcloud_client-1.0.483 → squidcloud_client-1.0.485}/PKG-INFO

@@ -1,22 +1,22 @@
-Metadata-Version: 2.4
-Name: squidcloud-client
-Version: 1.0.483
-Summary: Squid Cloud Python client SDK
-Author-email: Squid Cloud <support@squid.cloud>
-License: MIT
-Project-URL: Homepage, https://squid.cloud
-Project-URL: Documentation, https://docs.squid.cloud
-Project-URL: Repository, https://github.com/squid-cloud/squid-cloud
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Typing :: Typed
-Requires-Python: >=3.11
-Requires-Dist: httpx>=0.27.0
-Provides-Extra: dev
-Requires-Dist: pytest>=7.0; extra == "dev"
-Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
-Requires-Dist: ruff>=0.11.0; extra == "dev"
+Metadata-Version: 2.4
+Name: squidcloud-client
+Version: 1.0.485
+Summary: Squid Cloud Python client SDK
+Author-email: Squid Cloud <support@squid.cloud>
+License: MIT
+Project-URL: Homepage, https://squid.cloud
+Project-URL: Documentation, https://docs.squid.cloud
+Project-URL: Repository, https://github.com/squid-cloud/squid-cloud
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
+Requires-Dist: ruff>=0.11.0; extra == "dev"

{squidcloud_client-1.0.483 → squidcloud_client-1.0.485}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "squidcloud-client"
-version = "1.0.483"
+version = "1.0.485"
 description = "Squid Cloud Python client SDK"
 requires-python = ">=3.11"
 license = {text = "MIT"}

{squidcloud_client-1.0.483 → squidcloud_client-1.0.485}/setup.cfg

@@ -1,4 +1,4 @@
-[egg_info]
-tag_build = 
-tag_date = 0
-
+[egg_info]
+tag_build = 
+tag_date = 0
+

{squidcloud_client-1.0.483 → squidcloud_client-1.0.485}/squidcloud/__init__.py

@@ -35,6 +35,7 @@ from squidcloud.matchmaking import MatchmakingClient
 from squidcloud.types import (
     AiAgent,
     AiAgentExecutionPlanOptions,
+    AiAgentMcpServerConfig,
     AiAgentMemoryOptions,
     AiAgentResponseFormat,
     AiAudioCreateSpeechOptions,
@@ -92,6 +93,7 @@ __all__ = [
     "AgentClient",
     "AiAgent",
     "AiAgentExecutionPlanOptions",
+    "AiAgentMcpServerConfig",
     "AiAgentMemoryOptions",
     "AiAgentResponseFormat",
     "AiAudioCreateSpeechOptions",

{squidcloud_client-1.0.483 → squidcloud_client-1.0.485}/squidcloud/ai.py

@@ -12,6 +12,7 @@ if TYPE_CHECKING:
     from squidcloud.http import HttpTransport
     from squidcloud.types import (
         AiAgent,
+        AiAgentMcpServerConfig,
         AiAudioCreateSpeechOptions,
         AiChatModelSelection,
         AiChatOptions,
@@ -231,7 +232,8 @@ class AgentClient:
 
         Returns:
             An ``AiAgent`` dict with keys: ``id``, ``createdAt``, ``updatedAt``,
-            ``description``, ``isPublic``, ``auditLog``, ``options``, ``apiKey``.
+            ``description``, ``isPublic``, ``auditLog``, ``auditLogFullContext``,
+            ``options``, ``apiKey``.
             Returns ``None`` if the agent does not exist.
         """
         return await self._http.get(f"squid-api/v1/ai/agent/get/{self._agent_id}")
@@ -242,7 +244,9 @@ class AgentClient:
         description: str | None = None,
         is_public: bool | None = None,
         audit_log: bool | None = None,
+        audit_log_full_context: bool | None = None,
         api_key: str | None = None,
+        mcp_server: AiAgentMcpServerConfig | None = None,
         options: AiChatOptions | None = None,
     ) -> None:
         """Create or update the agent.
@@ -254,7 +258,12 @@ class AgentClient:
             description: A description of the agent's purpose or capabilities.
             is_public: Whether the agent is publicly accessible (default ``False``).
             audit_log: Enable audit logging for the agent's activities.
+            audit_log_full_context: Record the full agent context (system
+                instructions and retrieved knowledge-base content) in the audit
+                log; requires ``audit_log``.
             api_key: Optional API key used specifically for this agent.
+            mcp_server: Configuration for exposing the agent as an MCP server
+                at ``/mcp/<agentId>``. See :class:`AiAgentMcpServerConfig`.
             options: Default chat options applied to every request unless
                 overridden per-call. See :class:`AiChatOptions`.
 
@@ -272,8 +281,12 @@ class AgentClient:
             body["isPublic"] = is_public
         if audit_log is not None:
             body["auditLog"] = audit_log
+        if audit_log_full_context is not None:
+            body["auditLogFullContext"] = audit_log_full_context
         if api_key is not None:
             body["apiKey"] = api_key
+        if mcp_server is not None:
+            body["mcpServer"] = mcp_server
         if options is not None:
             body["options"] = options
         await self._http.post("squid-api/v1/ai/agent/upsert", body)

{squidcloud_client-1.0.483 → squidcloud_client-1.0.485}/squidcloud/http.py

@@ -19,7 +19,6 @@ _KOTLIN_CONTROLLERS = frozenset(
         "auth",
         "mutation",
         "native-query",
-        "notification",
         "query",
         "queue",
     ]
@@ -33,14 +32,10 @@ def _is_local(region: str) -> bool:
 def _is_kotlin_path(path: str) -> bool:
     """Returns True if the given path is served by Kotlin core in local dev (port 8001).
 
-    Mirrors ``isKotlinPath()`` from ``internal-common/src/utils/http.ts``. Encodes the
-    WebSocket split: ``/ws/squidlet`` stays on Kotlin while other ``/ws/*`` paths
-    (general, localdev) are owned by the TypeScript core.
+    Mirrors ``isKotlinPath()`` from ``internal-common/src/utils/http.ts``: every ``/ws/*``
+    path is served by the TypeScript core (port 8000), so no controller name is special-cased.
     """
-    segments = path.split("/")
-    first = segments[0]
-    if first == "ws":
-        return len(segments) > 1 and segments[1] == "squidlet"
+    first = path.lstrip("/").split("/")[0]
     return first in _KOTLIN_CONTROLLERS
 
 

{squidcloud_client-1.0.483 → squidcloud_client-1.0.485}/squidcloud/types.py

@@ -336,6 +336,21 @@ class AiQueryOptions(TypedDict, total=False):
 # --- Agent management types ---
 
 
+class AiAgentMcpServerConfig(TypedDict, total=False):
+    """Configuration for exposing an AI agent as an MCP server at ``/mcp/<agentId>``."""
+
+    enabled: bool
+    """Whether the agent is exposed as an MCP server. Required."""
+    description: str
+    """Description of the MCP server, served as the ``instructions`` field of the MCP initialize result."""
+    toolDescription: str
+    """Description of the MCP ``ask`` tool, exposed in the tools manifest."""
+    oauthIntegrationId: str
+    """ID of an auth integration used to OAuth-protect the MCP server."""
+    requireApiKey: bool
+    """Require the agent's API key as a bearer token; combinable with OAuth (either is accepted)."""
+
+
 class UpsertAgentOptions(TypedDict, total=False):
     """Options for creating/updating an agent."""
 
@@ -345,8 +360,12 @@ class UpsertAgentOptions(TypedDict, total=False):
     """Whether the agent is publicly accessible."""
     auditLog: bool
     """Enable audit logging."""
+    auditLogFullContext: bool
+    """Record the full agent context (system instructions and retrieved knowledge-base content) in the audit log."""
     apiKey: str
     """API key for this agent."""
+    mcpServer: AiAgentMcpServerConfig
+    """Optional configuration for exposing the agent as an MCP server."""
     options: AiChatOptions
     """Default chat options."""
 
@@ -369,10 +388,14 @@ class AiAgent(TypedDict, total=False):
     """Whether the agent is publicly accessible; defaults to False."""
     auditLog: bool
     """Whether audit logging is enabled for the agent's activities; defaults to False."""
+    auditLogFullContext: bool
+    """Whether the full agent context (system instructions and retrieved knowledge-base content) is recorded in the audit log; requires auditLog; defaults to False."""
     options: AiChatOptions
     """The agent's default chat options, overridable by the user during use. Required."""
     apiKey: str
     """Optional API key used specifically for operations on this agent."""
+    mcpServer: AiAgentMcpServerConfig
+    """Optional configuration for exposing the agent as an MCP server."""
 
 
 # --- Knowledge base types ---
@@ -461,6 +484,12 @@ class FileContextRequest(TypedDict, total=False):
     type: Literal["file"]
     metadata: dict[str, Any]
     extractImages: bool
+    """Whether to extract and describe images in the file. Defaults to True.
+
+    This is the opposite of the text context default, which is False: a file's charts and
+    scanned pages carry content its text layer does not, while images referenced from pasted
+    markdown/HTML are usually layout chrome.
+    """
     imageMinSizePixels: int
     extractionModel: AiChatModelSelection
     options: AiContextFileOptions
@@ -666,7 +695,7 @@ class ExtractDataFromDocumentOptions(TypedDict, total=False):
     """Options for document data extraction."""
 
     extractImages: bool
-    """Whether to extract embedded images."""
+    """Whether to extract embedded images. Defaults to True."""
     imageMinSizePixels: int
     """Minimum image size to extract."""
     pageIndexes: list[int]

{squidcloud_client-1.0.483 → squidcloud_client-1.0.485}/squidcloud_client.egg-info/PKG-INFO

@@ -1,22 +1,22 @@
-Metadata-Version: 2.4
-Name: squidcloud-client
-Version: 1.0.483
-Summary: Squid Cloud Python client SDK
-Author-email: Squid Cloud <support@squid.cloud>
-License: MIT
-Project-URL: Homepage, https://squid.cloud
-Project-URL: Documentation, https://docs.squid.cloud
-Project-URL: Repository, https://github.com/squid-cloud/squid-cloud
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Typing :: Typed
-Requires-Python: >=3.11
-Requires-Dist: httpx>=0.27.0
-Provides-Extra: dev
-Requires-Dist: pytest>=7.0; extra == "dev"
-Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
-Requires-Dist: ruff>=0.11.0; extra == "dev"
+Metadata-Version: 2.4
+Name: squidcloud-client
+Version: 1.0.485
+Summary: Squid Cloud Python client SDK
+Author-email: Squid Cloud <support@squid.cloud>
+License: MIT
+Project-URL: Homepage, https://squid.cloud
+Project-URL: Documentation, https://docs.squid.cloud
+Project-URL: Repository, https://github.com/squid-cloud/squid-cloud
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
+Requires-Dist: ruff>=0.11.0; extra == "dev"