managed-deepagents 0.6.2.dev49__py3-none-win_amd64.whl → 0.6.2.dev50__py3-none-win_amd64.whl

managed_deepagents/_agent_auth.py

@@ -16,6 +16,7 @@ from managed_deepagents._agent_auth_http import (
     CredentialStoreError,
     agent_auth_credential_query,
     agent_auth_headers,
+    missing_workspace_connection_error,
     request_agent_auth_json,
 )
 
@@ -269,7 +270,7 @@ class AgentAuth:
         """Start an OAuth session for a slug the caller has not granted."""
         connection = self.find_workspace_connection(slug)
         if connection is None:
-            raise CredentialStoreError(f"workspace connection {slug!r} is not configured")
+            raise missing_workspace_connection_error(slug)
         if connection.kind != "oauth2":
             raise CredentialStoreError(f"connection {slug!r} is not an OAuth connection")
         status, body = self._request(

managed_deepagents/_agent_auth_http.py

@@ -7,6 +7,7 @@ API with the same headers, redirect policy, and page walker.
 from __future__ import annotations
 
 import json
+import re
 import urllib.error
 import urllib.parse
 import urllib.request
@@ -66,6 +67,27 @@ class CredentialStoreError(RuntimeError):
         super().__init__(with_status if hint is None else f"{with_status}: {hint}")
 
 
+# Each runtime quotes the slug its own way: repr() here, JSON.stringify in npm.
+_MISSING_WORKSPACE_CONNECTION = re.compile(
+    r"""workspace connection ['"]([A-Za-z0-9][A-Za-z0-9._-]*)['"] is not configured"""
+)
+
+
+def missing_workspace_connection_error(slug: str) -> CredentialStoreError:
+    """Return the error for a declared slug that has no workspace connection row."""
+    return CredentialStoreError(f"workspace connection {slug!r} is not configured")
+
+
+def missing_workspace_connection_slug(text: str) -> str | None:
+    """Read the slug back out of a missing-connection message.
+
+    A run that fails in the gate reaches a channel as a plain string, so this is
+    the only way back to the slug. It must move with the message it parses.
+    """
+    match = _MISSING_WORKSPACE_CONNECTION.search(text)
+    return None if match is None else match.group(1)
+
+
 __all__ = [
     "AGENT_AUTH_PROBLEM_HINT_MAX_CHARS",
     "AGENT_AUTH_TIMEOUT_SECONDS",
@@ -73,6 +95,8 @@ __all__ = [
     "agent_auth_credential_query",
     "agent_auth_headers",
     "agent_auth_problem_hint",
+    "missing_workspace_connection_error",
+    "missing_workspace_connection_slug",
     "request_agent_auth_json",
 ]
 

managed_deepagents/_channels/trigger/http.py

@@ -9,6 +9,7 @@ from collections.abc import Awaitable, Callable, Mapping
 from importlib import import_module
 from typing import Protocol, TypeVar
 
+from managed_deepagents._agent_auth_http import missing_workspace_connection_slug
 from managed_deepagents._channels.assistant_text import extract_assistant_text
 from managed_deepagents._channels.trigger.client import (
     LANGSMITH_MDA_TRIGGER_SERVER_URL_ENV,
@@ -242,6 +243,7 @@ async def _observe_accepted_run(
     async def lifecycle(
         event_type: TriggerChannelRuntimeEventType,
         interrupts: list[TriggerChannelInterrupt] | None = None,
+        message: str | None = None,
     ) -> None:
         logger.info(
             "Channel outgoing event (type=%s, delivery_id=%s, channel_id=%s, run_id=%s)",
@@ -253,7 +255,7 @@ async def _observe_accepted_run(
         await _best_effort(
             client.post_runtime_event(
                 event["channel_id"],
-                _runtime_event(event_type, event, started, interrupts),
+                _runtime_event(event_type, event, started, interrupts, message),
             )
         )
 
@@ -266,8 +268,8 @@ async def _observe_accepted_run(
             source_thread_key=source_thread_key,
             user_id=user_id,
         )
-    except Exception:  # noqa: BLE001 - observation details stay internal
-        await lifecycle("run.failed")
+    except Exception as error:  # noqa: BLE001 - only known-safe details leave runtime
+        await lifecycle("run.failed", message=_missing_connection_failure_message(error))
         return
 
     if _is_interrupted_run(observed):
@@ -391,6 +393,7 @@ def _runtime_event(
     event: TriggerChannelEvent,
     started: StartedIngressRun,
     interrupts: list[TriggerChannelInterrupt] | None = None,
+    message: str | None = None,
 ) -> TriggerChannelRuntimeEventRequest:
     request: TriggerChannelRuntimeEventRequest = {
         "id": str(uuid.uuid4()),
@@ -401,11 +404,24 @@ def _runtime_event(
         "run_thread_id": started["thread_id"],
         "run_id": started["run_id"],
     }
+    if message:
+        request["message"] = {"text": message}
     if interrupts:
         request["interrupts"] = interrupts
     return request
 
 
+def _missing_connection_failure_message(error: Exception) -> str | None:
+    slug = missing_workspace_connection_slug(str(error))
+    if slug is None:
+        return None
+    return (
+        f"This agent can't respond because the `{slug}` connection isn't configured. "
+        "An agent developer can configure it with "
+        f"`mda connections create {slug} --project <project>`, then try again."
+    )
+
+
 def _thread_id(source_thread_key: str) -> str:
     return str(uuid.uuid5(uuid.NAMESPACE_URL, source_thread_key))
 

managed_deepagents/_channels/trigger/types.py

@@ -119,6 +119,8 @@ class TriggerChannelRuntimeEventRequestRequired(TypedDict):
 
 
 class TriggerChannelRuntimeEventRequest(TriggerChannelRuntimeEventRequestRequired, total=False):
+    # Safe, user-facing status text. Raw runtime exceptions must never be sent.
+    message: TriggerChannelActionMessage
     # Present on `run.interrupted`. The Trigger Server cannot read the
     # deployment's threads, so pending interrupts travel on the event itself.
     interrupts: list[TriggerChannelInterrupt]

managed_deepagents/_credential_gate.py

@@ -20,8 +20,8 @@ from managed_deepagents._agent_auth import (
     AgentAuth,
     AgentAuthContext,
     CredentialAuthorizationRequiredError,
-    CredentialStoreError,
     PendingAuthorization,
+    missing_workspace_connection_error,
 )
 from managed_deepagents._connections import (
     ConnectionReference,
@@ -187,7 +187,7 @@ def _read_user_connection_grants(
         slug = reference.slug
         row = agent_auth.find_workspace_connection(slug)
         if row is None:
-            raise CredentialStoreError(f"workspace connection {slug!r} is not configured")
+            raise missing_workspace_connection_error(slug)
         kind: Literal["oauth2", "secret"] = "secret" if row.kind == "secret" else "oauth2"
         token = (
             agent_auth.read_user_secret_for_connection(row)

{managed_deepagents-0.6.2.dev49.dist-info → managed_deepagents-0.6.2.dev50.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: managed-deepagents
-Version: 0.6.2.dev49
+Version: 0.6.2.dev50
 Summary: Managed Deep Agents — the define_deep_agent authoring interface plus the CLI that compiles and deploys a code-first Deep Agent repository to a managed LangGraph runtime.
 Author: LangChain
 License: MIT

{managed_deepagents-0.6.2.dev49.dist-info → managed_deepagents-0.6.2.dev50.dist-info}/RECORD

@@ -1,13 +1,13 @@
 managed_deepagents/__init__.py,sha256=RezkpgYxCcywj6_W7Nk3PN9TMBfYyFgIatxGrIeY8V4,1862
 managed_deepagents/__main__.py,sha256=GcjmqN0Ea5v8OHKMxYToasm3eCX_doSLOlpEzAi1tAw,67
-managed_deepagents/_agent_auth.py,sha256=bOxTT1ZX9BZZyvgIaxd9SZycbEaQl-HuCrPieCAv6G0,17258
-managed_deepagents/_agent_auth_http.py,sha256=aCYn7Rrtw3cnK3r4ir4JWxwzFkb7cF7nBgPpNdydxDw,5108
+managed_deepagents/_agent_auth.py,sha256=DCGZNfMUpUEwLQT7tIODywmtzO3XjF4a1dixuDR_Fzs,17266
+managed_deepagents/_agent_auth_http.py,sha256=d-Fg62m-_5qBXj-d9xgfA3KGiPRfs7T2g6Q2nrhCetc,6065
 managed_deepagents/_channel.py,sha256=-Og7QOM1yvV-yeTDOfv2CxXpR2HLY4xdX1bLrIsPi5k,5272
 managed_deepagents/_cli.py,sha256=jVaw2i1ysdRoWziMdPFmRXtKry_baYGRspyzyIeGWoU,1688
 managed_deepagents/_connections.py,sha256=VwVBwM4T0rp1MgYu9D8QjGj1ireYeEuP3VIAFN5urFY,16246
 managed_deepagents/_connector.py,sha256=Syp0SRs1oFCUUltIUmZbSNi1Ys_PxObVdiAi-I9GBzs,8040
 managed_deepagents/_cors.py,sha256=V96RPrqewdRWG5RpEMEBnPuRq9_zF8nf4vf99k5dkuI,7597
-managed_deepagents/_credential_gate.py,sha256=SNxXunqmHgjBsZpiZu8yp49YkRIO0amkl0-7GHLGnIg,12280
+managed_deepagents/_credential_gate.py,sha256=thc9dqWphPKbNqWYEZ1P63mpMDyUPDTw4uPA_qqnW28,12262
 managed_deepagents/_eval_filesystem.py,sha256=1nuD0yn3gh19JrWNocWyPFyeJW42E7Gse3XRWCUSTAA,1399
 managed_deepagents/_extension.py,sha256=x2H1S8inkvTZQ_dr7kq0M8o8rre1FjzCDvMzItw4iyk,5318
 managed_deepagents/_identity_auth.py,sha256=l0t0Xx-J1-z_Zw4K5D-B2yV6lNdeJgOw7UvxODxUxZQ,32798
@@ -28,7 +28,7 @@ managed_deepagents/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
 managed_deepagents/runtime.py,sha256=B4iKTJZD0zXx_MZ09pqQFOkVo07tqJDT3qvOBr-0iOk,65782
 managed_deepagents/sandbox.py,sha256=xlpcWa6CoVX6GKip2nK-0Lw-HBCoFGFYm0r4x9eYwcY,2530
 managed_deepagents/schedules.py,sha256=MtTQN4tlm1NizFDCjZZv_huGfbQx-dj9WP1dIBybCug,5237
-managed_deepagents/_binaries/mda.exe,sha256=si-RbXt5o5HhOiAutrI8z5I4zerLvIo8iF1pKuJ1D8s,3904512
+managed_deepagents/_binaries/mda.exe,sha256=MKHDoU4yrPlrylogVcQ8MmsJKXs7r6MzRI3OPV6z5fg,3904512
 managed_deepagents/_channels/__init__.py,sha256=Z6eXmzaLxG09DSyJoY_CX34axcsBo9gSJ0G7pRm2D6M,1216
 managed_deepagents/_channels/assistant_text.py,sha256=f-Z3J3PlQFXZHztgBxlRoqB2LigU1Hj1YpwoXBMTR18,2171
 managed_deepagents/_channels/binding.py,sha256=6vAKbWpg-eyLErJ0SsozH4mZc50hA1NhquM63mVmWDQ,3423
@@ -50,9 +50,9 @@ managed_deepagents/_channels/slack/transport.py,sha256=_xQmzK2hBpPOoY3zKFhzc3vvl
 managed_deepagents/_channels/trigger/__init__.py,sha256=bWj66XoPbDdrztPUCKBuSJBBS2pBocn4EA8FDE3WeBA,48
 managed_deepagents/_channels/trigger/channel.py,sha256=rKSvOABOZX58ZIvZ3hKcYxvTx9npQ0YXPQWk9JEy6XE,5108
 managed_deepagents/_channels/trigger/client.py,sha256=cM97gzYWUTFC9o3uoveFe9-HxZc6_VqiqC8u4fKqjXc,8572
-managed_deepagents/_channels/trigger/http.py,sha256=O8yMleioXj3s5QXj7jK-HpUpiSFppjfRjHJ2tdfX0Is,16205
+managed_deepagents/_channels/trigger/http.py,sha256=75ROtdT7PacKAFa-KFFRPATkHDgC7Pu48AUcipTYXY0,16903
 managed_deepagents/_channels/trigger/identity_context.py,sha256=oo6sgtNDLGGkZCzrkrifMHkkAqxj7ui2HgUUdjNA1iU,7701
-managed_deepagents/_channels/trigger/types.py,sha256=42JMOFXP9MfqwQ66SFlAiwC7q_AnNIJXBts3sAujxac,6625
+managed_deepagents/_channels/trigger/types.py,sha256=9nlArhLf-KgYidxwzrtBVjcpPlV6ytriPX3lJvPR3fE,6746
 managed_deepagents/_connectors/__init__.py,sha256=c_SdH3T7T6bgX7-I5jxAqDzHojmqVUCX0AXRI7g5Ovs,575
 managed_deepagents/_connectors/tool_selection.py,sha256=xMvohEvg_rguQvziUXzxKn4V140mmearZHel97F8tVs,2978
 managed_deepagents/_connectors/mcp/__init__.py,sha256=3AL429g5djYEYuiuSqsxj2VESpTkyU2NeBIJsHlWVk4,11162
@@ -69,9 +69,9 @@ managed_deepagents/identity/__init__.py,sha256=Slm-oEqKxbaZEQsMqHfD3LbG5M4vH2lKU
 managed_deepagents/identity/claims.py,sha256=prby7r_8Lww3MmoBm8PX6PsSGE3GwSHkr8mVIz_08nU,1180
 managed_deepagents/identity/options.py,sha256=x_yMbXEFR7zXyehEjDHG2qjAlukXjrRBcQLcM6IndLM,2550
 managed_deepagents/identity/supabase.py,sha256=8uobl3WCrQL_ieSXG8KTLf1th7Qjim9liZT50HeaJE0,6026
-managed_deepagents-0.6.2.dev49.dist-info/licenses/LICENSE,sha256=WnPZQQ608ojZUkXl7BW6VbKloIAibZiGm1K6cjeZOL8,1066
-managed_deepagents-0.6.2.dev49.dist-info/METADATA,sha256=7QuGJwj6TqzMO7JMsCPCm51hE7Bmk-H0hvKWNGH4ZHU,13718
-managed_deepagents-0.6.2.dev49.dist-info/WHEEL,sha256=3I5VVWZdsFlU417aCS2bMRuerS8wsfvBq99MyatBV3A,97
-managed_deepagents-0.6.2.dev49.dist-info/entry_points.txt,sha256=ziZqkKuaDO3qHCjKmBhrx9cm3ok8bZ9xcEDpUTj4unM,53
-managed_deepagents-0.6.2.dev49.dist-info/top_level.txt,sha256=fdBo4O0Hlol_w022tTLB5ftZpamb4yJoQ3MUvjgTGfA,19
-managed_deepagents-0.6.2.dev49.dist-info/RECORD,,
+managed_deepagents-0.6.2.dev50.dist-info/licenses/LICENSE,sha256=WnPZQQ608ojZUkXl7BW6VbKloIAibZiGm1K6cjeZOL8,1066
+managed_deepagents-0.6.2.dev50.dist-info/METADATA,sha256=jGDCHaAI4JMsFMrZ_fhKDqt6PVYObwGB3vD_HoY_fxU,13718
+managed_deepagents-0.6.2.dev50.dist-info/WHEEL,sha256=3I5VVWZdsFlU417aCS2bMRuerS8wsfvBq99MyatBV3A,97
+managed_deepagents-0.6.2.dev50.dist-info/entry_points.txt,sha256=ziZqkKuaDO3qHCjKmBhrx9cm3ok8bZ9xcEDpUTj4unM,53
+managed_deepagents-0.6.2.dev50.dist-info/top_level.txt,sha256=fdBo4O0Hlol_w022tTLB5ftZpamb4yJoQ3MUvjgTGfA,19
+managed_deepagents-0.6.2.dev50.dist-info/RECORD,,