muse-code-sdk 1.4.7__tar.gz → 1.4.9__tar.gz

{muse_code_sdk-1.4.7/src/muse_code_sdk.egg-info → muse_code_sdk-1.4.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: muse-code-sdk
-Version: 1.4.7
+Version: 1.4.9
 Summary: Muse Code SDK for MSP: asyncio-first facade over the generated wire types (muse-code-msp), with a thin sync wrapper.
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/meta-models/muse-code-sdk

{muse_code_sdk-1.4.7 → muse_code_sdk-1.4.9}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "muse-code-sdk"
-version = "1.4.7"
+version = "1.4.9"
 description = "Muse Code SDK for MSP: asyncio-first facade over the generated wire types (muse-code-msp), with a thin sync wrapper."
 readme = "README.md"
 requires-python = ">=3.10"

{muse_code_sdk-1.4.7 → muse_code_sdk-1.4.9}/src/muse_code/__init__.py

@@ -80,7 +80,7 @@ __all__ = [
 ]
 
 EXPECTED_SCHEMA_FINGERPRINT: Final[str] = (
-    "sha256:6de32db08bbbe0deb478d2bfcaba001e9fb490986bc80db3aceb4d996abf7df9"
+    "sha256:5d3b43e5ccdb7dc4f5a32c380f5f2cde0f10e3059b93610afb2e73f73b1d914c"
 )
 """The stable schema-bundle fingerprint this SDK was built against.
 
@@ -92,7 +92,7 @@ Python SDK reds this lane instead of drifting silently.
 # The lockstep rule: the release train bumps pyproject.toml, the
 # distribution-metadata authority; this constant is aligned at publication
 # time.
-__version__: Final[str] = "1.4.7"
+__version__: Final[str] = "1.4.9"
 
 # The facade is imported last so the constants above are already bound: the
 # spawn path reads ``EXPECTED_SCHEMA_FINGERPRINT`` (lazily, at initialize

{muse_code_sdk-1.4.7 → muse_code_sdk-1.4.9}/src/muse_code/facade/client.py

@@ -130,12 +130,17 @@ class ResumeSessionOptions:
         exclude_items: Ask the host to omit item bodies from the history.
         history: The history preference forwarded as the wire's ``history``
             member.
+        permission_profile: The permission profile pick forwarded as the
+            wire's ``permissionProfile`` member: the host restores the
+            retained authority first, then applies the pick. Omitted means
+            no override.
     """
 
     session_id: str
     cursor: str | None = None
     exclude_items: bool | None = None
     history: Mapping[str, Any] | None = None
+    permission_profile: str | None = None
 
 
 # Drift pins — the Python twin of the TS `AssertNever` on START_FORWARDED /
@@ -483,6 +488,8 @@ class MuseClient(Generic[_I]):
             params["excludeItems"] = options.exclude_items
         if options.history is not None:
             params["history"] = options.history
+        if options.permission_profile is not None:
+            params["permissionProfile"] = options.permission_profile
         return await self._open("session/resume", params, _ResumeOpening)
 
     async def close(self) -> None:

{muse_code_sdk-1.4.7 → muse_code_sdk-1.4.9}/src/muse_code/facade/turn_handle.py

@@ -97,9 +97,10 @@ class _TerminalUnknown:
 
 TurnOutcome = Union[_Completed, _Unqueued, _TerminalUnknown]
 """How a turn ended, from a waiter's point of view. ``turn/retracted``,
-``turn/retryScheduled``, and ``turn/foregroundCompleted`` are deliberately
-absent: a retracted turn still reaches its own terminal, and a scheduled
-retry or a foreground notice is explicitly non-terminal."""
+``turn/retryScheduled``, ``turn/modelRetryScheduled``, and
+``turn/foregroundCompleted`` are deliberately absent: a retracted turn still
+reaches its own terminal, and a scheduled retry, a scheduled backoff, or a
+foreground notice is explicitly non-terminal."""
 
 
 def is_launch_failure(outcome: TurnOutcome) -> bool:

{muse_code_sdk-1.4.7 → muse_code_sdk-1.4.9}/src/muse_code/fold/__init__.py

@@ -21,6 +21,7 @@ from .session_fold import (
     LIVE_HOST_STATE_PROJECTIONS,
     VIEW_EVENT_METHODS,
     ApprovalPending,
+    ApprovalReviewingNotice,
     ApprovalResolvedFold,
     DeliveryGap,
     FoldItems,
@@ -48,6 +49,7 @@ __all__ = [
     "VIEW_EVENT_METHODS",
     "Appended",
     "ApprovalPending",
+    "ApprovalReviewingNotice",
     "ApprovalResolvedFold",
     "BufferedForAbsentItem",
     "DeliveryGap",

{muse_code_sdk-1.4.7 → muse_code_sdk-1.4.9}/src/muse_code/fold/session_fold.py

@@ -10,7 +10,8 @@ are neither an item nor a state family:
 
 - the TURN LIFECYCLE — ``turn/started``, ``turn/completed``,
   ``turn/retracted``, ``turn/unqueued``, and the non-terminal
-  ``turn/retryScheduled`` and ``turn/foregroundCompleted``;
+  ``turn/retryScheduled``, ``turn/modelRetryScheduled``, and
+  ``turn/foregroundCompleted``;
 - the APPROVAL and USER-INPUT view events as fold INPUTS — the pending sets
   and their first durable terminal. The decision flow (choosing and sending a
   resolution) is the facade's, not the fold's;
@@ -71,8 +72,12 @@ VIEW_EVENT_METHODS: frozenset[str] = frozenset(
         "turn/foregroundCompleted",
         "turn/retracted",
         "turn/retryScheduled",
+        "turn/modelRetryScheduled",
         "turn/unqueued",
         "approval/requested",
+        # The reviewer-held twin of `approval/requested`: routed to its own
+        # non-storing notice.
+        "approval/reviewing",
         "approval/updated",
         "approval/resolved",
         "userInput/requested",
@@ -139,6 +144,9 @@ class TurnEntry:
             ``turn/completed`` folded.
         error: Present iff the terminal was ``"failed"``.
         retry_scheduled: The latest scheduled model retry; non-terminal.
+        model_retry_scheduled: The latest scheduled provider-backoff retry;
+            non-terminal. The model-attempt twin of ``retry_scheduled``;
+            clears on the turn's terminal.
         foreground_completed: The latest foreground-completed notice;
             non-terminal. Tells a renderer the answer is done while
             ``blockingAgents`` hold the turn; clears on the turn's terminal.
@@ -150,6 +158,7 @@ class TurnEntry:
     terminal: str | None = None
     error: Params | None = None
     retry_scheduled: Params | None = None
+    model_retry_scheduled: Params | None = None
     foreground_completed: Params | None = None
 
 
@@ -275,6 +284,19 @@ class ModelRouteUnservedNotice:
     provider_id: str | None
 
 
+@dataclass(frozen=True)
+class ApprovalReviewingNotice:
+    """The ``approval/reviewing`` typed-activity signal.
+
+    The host's built-in reviewer holds this approval. A notice, never a
+    pending entry: it seeds no store and opens no decision — the approval is
+    absent from ``pending_approvals`` until ``approval/requested`` releases it
+    to the human (or ``approval/resolved`` settles it) on the same id.
+    """
+
+    approval_id: str
+
+
 @dataclass(frozen=True)
 class IgnoredUnrecognizedMethod:
     """A newer host's method this SDK has never heard of."""
@@ -324,6 +346,7 @@ FoldOutcome = (
     | UserInputSettledFold
     | DeliveryGap
     | ModelRouteUnservedNotice
+    | ApprovalReviewingNotice
     | IgnoredUnrecognizedMethod
     | IgnoredMissingParams
     | IgnoredStaleFrame
@@ -422,6 +445,7 @@ class _InternalTurn:
     terminal: str | None = None
     error: Params | None = None
     retry_scheduled: Params | None = None
+    model_retry_scheduled: Params | None = None
     foreground_completed: Params | None = None
 
 
@@ -572,10 +596,14 @@ class SessionFold:
             return self._turn_unqueued(params)
         if method == "turn/retryScheduled":
             return self._turn_retry_scheduled(params)
+        if method == "turn/modelRetryScheduled":
+            return self._turn_model_retry_scheduled(params)
         if method == "turn/foregroundCompleted":
             return self._turn_foreground_completed(params)
         if method == "approval/requested":
             return self._approval_requested(params)
+        if method == "approval/reviewing":
+            return ApprovalReviewingNotice(approval_id=str(params["approvalId"]))
         if method == "approval/updated":
             return self._approval_updated(params)
         if method == "approval/resolved":
@@ -675,6 +703,9 @@ class SessionFold:
         # The retry hint is a "retrying in Ns" countdown, and it clears on the
         # turn's next event — which a completion is.
         turn.retry_scheduled = None
+        # Same for the provider-backoff hint: a finished turn is not
+        # waiting out a backoff.
+        turn.model_retry_scheduled = None
         # Same for the foreground hint: a finished turn is not
         # background-waiting.
         turn.foreground_completed = None
@@ -720,6 +751,18 @@ class SessionFold:
         turn.retry_scheduled = params
         return TurnFold(turn_id, turn.state)
 
+    def _turn_model_retry_scheduled(self, params: Params) -> FoldOutcome:
+        # Non-terminal by contract: it never resolves a turn-wait.
+        turn_id = str(params["turnId"])
+        turn = self._turn_for(turn_id)
+        # ...but it is still a turn frame, so it takes the same redelivery
+        # guard as the retry hint: a replayed page must not re-plant the
+        # provider-backoff hint on a turn that already left `running`.
+        if turn.state != "running":
+            return IgnoredStaleFrame("turn/modelRetryScheduled", turn_id)
+        turn.model_retry_scheduled = params
+        return TurnFold(turn_id, turn.state)
+
     def _turn_foreground_completed(self, params: Params) -> FoldOutcome:
         # Non-terminal by contract: it never resolves a turn-wait.
         turn_id = str(params["turnId"])
@@ -753,6 +796,7 @@ class SessionFold:
             terminal=turn.terminal,
             error=turn.error,
             retry_scheduled=turn.retry_scheduled,
+            model_retry_scheduled=turn.model_retry_scheduled,
             foreground_completed=turn.foreground_completed,
         )
 

{muse_code_sdk-1.4.7 → muse_code_sdk-1.4.9/src/muse_code_sdk.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: muse-code-sdk
-Version: 1.4.7
+Version: 1.4.9
 Summary: Muse Code SDK for MSP: asyncio-first facade over the generated wire types (muse-code-msp), with a thin sync wrapper.
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/meta-models/muse-code-sdk

{muse_code_sdk-1.4.7 → muse_code_sdk-1.4.9}/tests/test_facade_turn.py

@@ -139,6 +139,25 @@ def turn_retry_scheduled(turn_id: str, view_cursor: str) -> dict[str, Any]:
     }
 
 
+def turn_model_retry_scheduled(turn_id: str, view_cursor: str) -> dict[str, Any]:
+    return {
+        "method": "turn/modelRetryScheduled",
+        "params": {
+            "attempt": 2,
+            "errorKind": "overloaded",
+            "httpStatus": 529,
+            "maxAttempts": 5,
+            "nextAttempt": 3,
+            "retryDelayMs": 4_000,
+            "sessionId": SESSION,
+            "sourceRange": SOURCE,
+            "system": "meta",
+            "turnId": turn_id,
+            "viewCursor": view_cursor,
+        },
+    }
+
+
 def turn_foreground_completed(turn_id: str, view_cursor: str) -> dict[str, Any]:
     return {
         "method": "turn/foregroundCompleted",
@@ -331,6 +350,32 @@ async def test_turn_retry_scheduled_never_settles_the_wait() -> None:
     await watcher
 
 
+@pytest.mark.asyncio
+async def test_turn_model_retry_scheduled_never_settles_the_wait() -> None:
+    s = session()
+    turn = s.turn("t-1")
+    s.apply(turn_started("t-1", "v:1"))
+    s.apply(turn_model_retry_scheduled("t-1", "v:2"))
+
+    settled = False
+
+    async def watch() -> None:
+        nonlocal settled
+        await turn.completed
+        settled = True
+
+    import asyncio
+
+    watcher = asyncio.ensure_future(watch())
+    for _ in range(5):
+        await asyncio.sleep(0)
+    assert settled is False, "a scheduled backoff is a fact about a RUNNING turn"
+
+    s.apply(turn_completed("t-1", "completed", "v:3"))
+    assert (await turn.completed).kind == "completed"
+    await watcher
+
+
 @pytest.mark.asyncio
 async def test_turn_foreground_completed_never_settles_the_wait() -> None:
     s = session()

{muse_code_sdk-1.4.7 → muse_code_sdk-1.4.9}/tests/test_session_fold.py

@@ -15,6 +15,8 @@ from typing import Any
 from muse_code.fold import (
     LIVE_HOST_STATE_PROJECTIONS,
     VIEW_EVENT_METHODS,
+    ApprovalPending,
+    ApprovalReviewingNotice,
     ApprovalResolvedFold,
     DeliveryGap,
     FoldItems,
@@ -110,6 +112,25 @@ def retry_scheduled(turn_id: str, view_cursor: str) -> dict[str, Any]:
     }
 
 
+def model_retry_scheduled(turn_id: str, view_cursor: str) -> dict[str, Any]:
+    return {
+        "method": "turn/modelRetryScheduled",
+        "params": {
+            "attempt": 2,
+            "errorKind": "overloaded",
+            "httpStatus": 529,
+            "maxAttempts": 5,
+            "nextAttempt": 3,
+            "retryDelayMs": 4_000,
+            "sessionId": SESSION,
+            "sourceRange": SOURCE,
+            "system": "meta",
+            "turnId": turn_id,
+            "viewCursor": view_cursor,
+        },
+    }
+
+
 def foreground_completed(turn_id: str, view_cursor: str) -> dict[str, Any]:
     return {
         "method": "turn/foregroundCompleted",
@@ -159,6 +180,13 @@ def approval_requested(
     }
 
 
+def approval_reviewing(approval_id: str, view_cursor: str) -> dict[str, Any]:
+    # The reviewer-held twin of `approval/requested`: same params shape,
+    # different method.
+    event = approval_requested(approval_id, view_cursor)
+    return {"method": "approval/reviewing", "params": event["params"]}
+
+
 def approval_updated(
     approval_id: str, view_cursor: str, source_index: int = 1, command: str | None = None
 ) -> dict[str, Any]:
@@ -493,6 +521,58 @@ def test_a_replayed_page_never_re_plants_the_retry_hint_on_a_turn_that_left_runn
     assert fold.apply(retry) == IgnoredStaleFrame("turn/retryScheduled", "turn-1")
 
 
+def test_turn_model_retry_scheduled_is_non_terminal_the_turn_keeps_running() -> None:
+    fold = SessionFold()
+    fold.apply(turn_started("turn-1", "cmd-1", "v:s:1"))
+    fold.apply(model_retry_scheduled("turn-1", "v:s:2"))
+
+    assert fold.active_turn_id == "turn-1", "a scheduled backoff never settles a turn"
+    held = fold.turn("turn-1")
+    assert held is not None
+    assert held.state == "running"
+    assert held.model_retry_scheduled is not None
+    assert held.model_retry_scheduled["nextAttempt"] == 3
+
+
+def test_turn_completed_clears_the_provider_backoff_hint() -> None:
+    fold = SessionFold()
+    fold.apply(turn_started("turn-1", "cmd-1", "v:s:1"))
+    fold.apply(model_retry_scheduled("turn-1", "v:s:2"))
+    held = fold.turn("turn-1")
+    assert held is not None and held.model_retry_scheduled is not None, (
+        "the hint is set while the turn runs"
+    )
+
+    fold.apply(turn_completed("turn-1", "completed", "v:s:3"))
+
+    held = fold.turn("turn-1")
+    assert held is not None and held.model_retry_scheduled is None
+
+
+def test_a_replayed_page_never_re_plants_the_backoff_hint_on_a_turn_that_left_running() -> None:
+    fold = SessionFold()
+    backoff = model_retry_scheduled("turn-1", "v:s:2")
+    page = [
+        turn_started("turn-1", "cmd-1", "v:s:1"),
+        backoff,
+        turn_completed("turn-1", "cancelled", "v:s:3"),
+        turn_retracted("turn-1", "cmd-1", "v:s:4"),
+    ]
+    for event in page:
+        fold.apply(event)
+    held = fold.turn("turn-1")
+    assert held is not None and held.model_retry_scheduled is None, "in-order delivery is clean"
+
+    for event in page:
+        fold.apply(event)
+
+    held = fold.turn("turn-1")
+    assert held is not None
+    assert held.state == "retracted"
+    assert held.model_retry_scheduled is None, "the replayed hint is dropped"
+    assert fold.apply(backoff) == IgnoredStaleFrame("turn/modelRetryScheduled", "turn-1")
+
+
 def test_turn_completed_clears_the_foreground_hint() -> None:
     fold = SessionFold()
     fold.apply(turn_started("turn-1", "cmd-1", "v:s:1"))
@@ -1001,6 +1081,19 @@ def test_the_items_surface_is_an_allowlist_pinned_by_member_set() -> None:
     assert state_public == {"families", "get", "has"}
 
 
+def test_approval_reviewing_is_a_notice_that_opens_no_pending_approval() -> None:
+    # The host's built-in reviewer holds the approval; opening a pending
+    # entry here would defeat the presentation hold. The release arrives as
+    # `approval/requested` on the same id.
+    fold = SessionFold()
+    outcome = fold.apply(approval_reviewing("a-1", "v:s:1"))
+    assert outcome == ApprovalReviewingNotice(approval_id="a-1")
+    assert fold.pending_approvals() == []
+    released = fold.apply(approval_requested("a-1", "v:s:2"))
+    assert isinstance(released, ApprovalPending)
+    assert len(fold.pending_approvals()) == 1
+
+
 def test_every_generated_view_notification_is_routed_never_the_default() -> None:
     # The runtime twin of the TS AssertNever coverage pins, PLUS the routing
     # table: every generated notification except the handshake's
@@ -1081,9 +1174,11 @@ def test_every_generated_view_notification_is_routed_never_the_default() -> None
         "turn/completed": turn_completed("turn-t", "completed", "v:t:6"),
         "turn/retracted": turn_retracted("turn-t2", "cmd-t2", "v:t:7"),
         "turn/retryScheduled": retry_scheduled("turn-t3", "v:t:8"),
+        "turn/modelRetryScheduled": model_retry_scheduled("turn-t3", "v:t:8b"),
         "turn/foregroundCompleted": foreground_completed("turn-t5", "v:t:23"),
         "turn/unqueued": turn_unqueued("turn-t4", "cmd-t4", "v:t:9"),
         "approval/requested": approval_requested("a-t", "v:t:10"),
+        "approval/reviewing": approval_reviewing("a-r", "v:t:23"),
         "approval/updated": approval_updated("a-t", "v:t:10b"),
         "approval/resolved": approval_resolved("a-t", "approved", "v:t:11"),
         "userInput/requested": user_input_requested("u-t", "v:t:12"),