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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: squidcloud-client
-Version: 1.0.484
+Version: 1.0.485
 Summary: Squid Cloud Python client SDK
 Author-email: Squid Cloud <support@squid.cloud>
 License: MIT

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

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

{squidcloud_client-1.0.484 → 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.484 → 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,
@@ -245,6 +246,7 @@ class AgentClient:
         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.
@@ -260,6 +262,8 @@ class AgentClient:
                 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`.
 
@@ -281,6 +285,8 @@ class AgentClient:
             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.484 → 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.484 → 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."""
 
@@ -349,6 +364,8 @@ class UpsertAgentOptions(TypedDict, total=False):
     """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."""
 
@@ -377,6 +394,8 @@ class AiAgent(TypedDict, total=False):
     """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 ---

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: squidcloud-client
-Version: 1.0.484
+Version: 1.0.485
 Summary: Squid Cloud Python client SDK
 Author-email: Squid Cloud <support@squid.cloud>
 License: MIT