muse-code-sdk 1.3.1__tar.gz → 1.4.2__tar.gz

{muse_code_sdk-1.3.1/src/muse_code_sdk.egg-info → muse_code_sdk-1.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: muse-code-sdk
-Version: 1.3.1
+Version: 1.4.2
 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.3.1 → muse_code_sdk-1.4.2}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "muse-code-sdk"
-version = "1.3.1"
+version = "1.4.2"
 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.3.1 → muse_code_sdk-1.4.2}/src/muse_code/__init__.py

@@ -77,7 +77,7 @@ __all__ = [
 ]
 
 EXPECTED_SCHEMA_FINGERPRINT: Final[str] = (
-    "sha256:b1e6676d624e116e2c1b150fec3192200d2cbca8ed79898e44f8921759c7872f"
+    "sha256:61afea3112e0906e9dc3a536144278a74cb4b36fc6e20901a91d4432ba3568e2"
 )
 """The stable schema-bundle fingerprint this SDK was built against.
 
@@ -89,7 +89,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.3.1"
+__version__: Final[str] = "1.4.2"
 
 # 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.3.1 → muse_code_sdk-1.4.2}/src/muse_code/facade/client.py

@@ -23,7 +23,7 @@ from __future__ import annotations
 
 import asyncio
 from dataclasses import dataclass, fields
-from typing import Any, Awaitable, Generic, Mapping, Sequence, Set, TypeVar
+from typing import Any, Awaitable, Generic, List, Mapping, Sequence, Set, TypeVar
 
 from muse_code_msp import (
     ClientCapabilities,
@@ -77,6 +77,9 @@ class StartSessionOptions:
         session_id: A caller-chosen session id; omitted = the host mints one.
         workspace_root: The workspace the session works in; omitted = the
             host decides.
+        workspace_roots: The session's initial runtime workspace-root set
+            (wire ``workspaceRoots``; first root = the CWD). When
+            ``workspace_root`` is also given the two must agree.
         model_id: The model to serve the session with; omitted = the
             provider's default.
     """
@@ -85,6 +88,7 @@ class StartSessionOptions:
     provider_id: str | None = None
     session_id: str | None = None
     workspace_root: str | None = None
+    workspace_roots: List[str] | None = None
     model_id: str | None = None
 
 
@@ -322,6 +326,8 @@ class MuseClient(Generic[_I]):
             params["sessionId"] = options.session_id
         if options.workspace_root is not None:
             params["workspaceRoot"] = options.workspace_root
+        if options.workspace_roots is not None:
+            params["workspaceRoots"] = options.workspace_roots
         if options.model_id is not None:
             params["modelId"] = options.model_id
         raw = await self._connection.command("session/start", params)

{muse_code_sdk-1.3.1 → muse_code_sdk-1.4.2}/src/muse_code/facade/turn_submit.py

@@ -51,6 +51,9 @@ class SendUserTurnOptions(Generic[_I]):
         if_busy: How to treat a submit while a turn runs (wire ``ifBusy``).
         reasoning_effort: The turn's reasoning effort (wire
             ``reasoningEffort``).
+        workspace_roots: A sticky replacement of the session's runtime
+            workspace-root set for this turn and subsequent turns (wire
+            ``workspaceRoots``).
         composer_input: What to hand back to the composer if this submit is
             ever retired — the protocol restores the INPUT, not the wire parts.
             Optional: a consumer rendering nothing optimistically has nothing
@@ -61,6 +64,7 @@ class SendUserTurnOptions(Generic[_I]):
     display_text: str | None = None
     if_busy: IfBusy | None = None
     reasoning_effort: ReasoningEffort | None = None
+    workspace_roots: List[str] | None = None
     composer_input: _I | None = None
 
 
@@ -82,7 +86,7 @@ def _camel(field_name: str) -> str:
 # own field, never a wire member, so it is dropped
 # before the compare; `commandId`/`sessionId` are excluded because the
 # connection mints the first and the session owns the second.
-_TURN_WIRE_FIELDS = {"input", "display_text", "if_busy", "reasoning_effort"}
+_TURN_WIRE_FIELDS = {"input", "display_text", "if_busy", "reasoning_effort", "workspace_roots"}
 _TURN_EXCLUDED = {"commandId", "sessionId"}
 assert {
     _camel(f.name) for f in fields(SendUserTurnOptions) if f.name in _TURN_WIRE_FIELDS
@@ -283,4 +287,6 @@ class TurnSubmitter(Generic[_I]):
             params["ifBusy"] = options.if_busy
         if options.reasoning_effort is not None:
             params["reasoningEffort"] = options.reasoning_effort
+        if options.workspace_roots is not None:
+            params["workspaceRoots"] = options.workspace_roots
         return params

{muse_code_sdk-1.3.1 → muse_code_sdk-1.4.2/src/muse_code_sdk.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: muse-code-sdk
-Version: 1.3.1
+Version: 1.4.2
 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.3.1 → muse_code_sdk-1.4.2}/tests/test_publish_shape.py

@@ -103,20 +103,26 @@ def test_the_version_source_is_the_static_manifest_field() -> None:
         # eligibility. Publication is permitted at exactly this lockstep
         # version — never a train-external one — so
         # the equality here is what the published wheel's version claims.
-        # One-time lockstep exception (owner-directed 2026-09-21): the
-        # 1.3.0 PyPI files were deleted after publication and PyPI
-        # reserves deleted filenames forever, so the republish rides 1.3.1
-        # while the train stays at 1.3.0. Exactly this pair is allowed;
-        # anything else still requires lockstep equality.
-        assert (version == _host_version()) or (
-            (version, _host_version()) == ("1.3.1", "1.3.0")
-        ), (
+        assert version == _host_version(), (
             f"{distribution}: version {version!r} != the host manifest's "
             f"{_host_version()!r} (the version lockstep rule: only the "
             "release train moves these versions, in one commit)"
         )
 
 
+def test_the_runtime_version_matches_the_sdk_manifest() -> None:
+    import muse_code
+
+    # `muse_code.__version__` is a hand-kept copy of the manifest field; a
+    # release bump that moves one without the other ships a wheel that
+    # misreports its own version.
+    manifest_version = _pyproject(SDK_DIR)["project"]["version"]
+    assert muse_code.__version__ == manifest_version, (
+        f"muse_code.__version__ {muse_code.__version__!r} != "
+        f"muse-code-sdk manifest version {manifest_version!r}"
+    )
+
+
 def test_the_license_is_mit_with_shipped_text() -> None:
     for package_dir, (distribution, _) in PACKAGES.items():
         project = _pyproject(package_dir)["project"]

{muse_code_sdk-1.3.1 → muse_code_sdk-1.4.2}/tests/test_session_fold.py

@@ -806,6 +806,25 @@ def test_an_unrecognized_notification_method_folds_without_raising() -> None:
     assert fold.active_turn_id == "turn-1", "the rest of the fold is untouched"
 
 
+def test_a_session_lifecycle_broadcast_keeps_its_pre_enrollment_drop() -> None:
+    # The runtime twin of the TypeScript SDK's lifecycle pin: the generated
+    # NOTIFICATIONS union carries both lifecycle names, but they are
+    # control-plane broadcasts, not view events, and the fold deliberately
+    # keeps the pre-enrollment runtime answer (the same sanctioned initial
+    # drop the delivery-gap marker had before it became a fold input). This
+    # pin is the tripwire the SDK's conscious lifecycle surfacing must
+    # replace; it reds if a refactor makes a lifecycle frame seed an item or
+    # a state family instead.
+    fold = SessionFold()
+    fold.apply(turn_started("turn-1", "cmd-1", "v:s:1"))
+    for method in ("session/started", "session/closed"):
+        outcome = fold.apply({"method": method, "params": {"sessionId": SESSION}})
+        assert outcome == IgnoredUnrecognizedMethod(method)
+    assert fold.items.size == 0, "a lifecycle broadcast seeds no item"
+    assert fold.session_state.families() == [], "and no state family"
+    assert fold.active_turn_id == "turn-1", "the rest of the fold is untouched"
+
+
 def test_a_real_view_gap_frame_moves_the_folds_currency_and_no_store() -> None:
     fold = SessionFold()
     fold.apply(turn_started("turn-1", "cmd-1", "v:s:0"))
@@ -925,19 +944,34 @@ def test_every_generated_view_notification_is_routed_never_the_default() -> None
     # push, not a view-fold input — it reports that the live view stream died,
     # so it carries no cursor and folds into no transcript state. Excluded here
     # like the handshake's `initialized`; the client handles it out of band.
-    non_fold_notifications = {"initialized", "session/viewHealthChanged"}
-    assert VIEW_EVENT_METHODS == set(NOTIFICATIONS) - non_fold_notifications - LIVE_HOST_STATE_PROJECTIONS, (
+    # Deletion completion has no view envelope or fold state.
+    non_fold_notifications = {"initialized", "session/viewHealthChanged", "session/deleteCompleted"}
+    # Session lifecycle broadcasts (a session was loaded or unloaded on the
+    # host) are control-plane notifications, not view events — they carry no
+    # view envelope, so they are facade inputs, not fold inputs. Today a
+    # lifecycle frame keeps the pre-enrollment runtime answer
+    # (``IgnoredUnrecognizedMethod``, pinned by the lifecycle runtime test)
+    # until the SDK consciously surfaces the pair.
+    session_lifecycle_broadcasts = {"session/started", "session/closed"}
+    assert VIEW_EVENT_METHODS == (
+        set(NOTIFICATIONS)
+        - non_fold_notifications
+        - session_lifecycle_broadcasts
+        - LIVE_HOST_STATE_PROJECTIONS
+    ), (
         "a protocol enrollment added or retired a view notification; route it in "
         "SessionFold.apply (exclusions: `initialized`, the command-plane "
-        "session/viewHealthChanged push, and the live host-state projections, "
-        "the governing decision)"
+        "session/viewHealthChanged push, the session lifecycle broadcasts, and "
+        "the live host-state projections, the governing decision)"
     )
     # The reverse pin (the TS StaleExclusion twin): every excluded projection
     # names a REAL generated notification, so a retired or renamed method
     # cannot rot in the exclusion set as dead vocabulary.
-    assert (LIVE_HOST_STATE_PROJECTIONS | non_fold_notifications) <= set(NOTIFICATIONS), (
-        "an excluded method (live host-state projection or non-fold "
-        "notification) names no generated notification"
+    assert (
+        LIVE_HOST_STATE_PROJECTIONS | non_fold_notifications | session_lifecycle_broadcasts
+    ) <= set(NOTIFICATIONS), (
+        "an excluded method (live host-state projection, lifecycle broadcast, "
+        "or non-fold notification) names no generated notification"
     )
 
     by_method: dict[str, dict[str, Any]] = {