muse-code-sdk 1.3.0__tar.gz

muse_code_sdk-1.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Meta Platforms, Inc. and affiliates.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

muse_code_sdk-1.3.0/PKG-INFO

@@ -0,0 +1,47 @@
+Metadata-Version: 2.4
+Name: muse-code-sdk
+Version: 1.3.0
+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
+Project-URL: Repository, https://github.com/meta-models/muse-code-sdk
+Project-URL: Issues, https://github.com/meta-models/muse-code-sdk/issues
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic==2.13.5
+Dynamic: license-file
+
+# `muse-code-sdk`
+
+The MSP Python facade (spec `specs/638-muse-sdk-python`; the Python tier of
+tdd SS7.3, chartered by issue #638). Mirrors `@muse-code/sdk`
+(`clients/sdk-ts`): asyncio-first — async iterators for turn streams,
+awaitable approvals — with a thin sync loop-runner for scripts and
+notebooks.
+
+**One runtime dependency**: `pydantic`, exact-pinned (the ADR 638 D2
+supply-chain exception, #211 O-3 form). The generated wire types live in
+`muse-code-msp` (`clients/msp-py`) and are never restated here.
+
+**Status: S0 skeleton.** The facade surface lands slice by slice
+(`specs/638-muse-sdk-python/plan.md` S1–S4); the first acceptance milestone
+is the quickstart journey against a release-built host. Python 3.10+.
+
+## The loop
+
+```sh
+cd projects/tbh
+python3 -m pip install -r clients/py-dev-requirements.txt
+python3 -m pip install -e clients/msp-py -e clients/sdk-py
+pytest clients/sdk-py/tests
+mypy --strict clients/msp-py/src clients/sdk-py/src
+```
+
+CI runs exactly this in the non-required, path-filtered `tbh-muse-sdk-py`
+workflow, on the floor Python (3.10) and a current one.

muse_code_sdk-1.3.0/README.md

@@ -0,0 +1,28 @@
+# `muse-code-sdk`
+
+The MSP Python facade (spec `specs/638-muse-sdk-python`; the Python tier of
+tdd SS7.3, chartered by issue #638). Mirrors `@muse-code/sdk`
+(`clients/sdk-ts`): asyncio-first — async iterators for turn streams,
+awaitable approvals — with a thin sync loop-runner for scripts and
+notebooks.
+
+**One runtime dependency**: `pydantic`, exact-pinned (the ADR 638 D2
+supply-chain exception, #211 O-3 form). The generated wire types live in
+`muse-code-msp` (`clients/msp-py`) and are never restated here.
+
+**Status: S0 skeleton.** The facade surface lands slice by slice
+(`specs/638-muse-sdk-python/plan.md` S1–S4); the first acceptance milestone
+is the quickstart journey against a release-built host. Python 3.10+.
+
+## The loop
+
+```sh
+cd projects/tbh
+python3 -m pip install -r clients/py-dev-requirements.txt
+python3 -m pip install -e clients/msp-py -e clients/sdk-py
+pytest clients/sdk-py/tests
+mypy --strict clients/msp-py/src clients/sdk-py/src
+```
+
+CI runs exactly this in the non-required, path-filtered `tbh-muse-sdk-py`
+workflow, on the floor Python (3.10) and a current one.

muse_code_sdk-1.3.0/pyproject.toml

@@ -0,0 +1,43 @@
+[build-system]
+# >=77: the floor that understands PEP 639 (SPDX license + license-files).
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "muse-code-sdk"
+version = "1.3.0"
+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"
+license = "MIT"
+license-files = ["LICENSE"]
+# Exactly ONE runtime dependency, exact-pinned: the ADR 638 D2 supply-chain
+# exception (#211 O-3 form). Any second dependency is an owner escalation;
+# bumps are deliberate reviewed PRs (see the ADR's review policy).
+# muse-code-msp is deliberately NOT declared: it is not on the registry yet,
+# and promoting it is the owner escalation decided with the first publish
+# (the @muse-code/msp devDependency precedent; test_publish_shape pins this).
+dependencies = ["pydantic==2.13.5"]
+classifiers = [
+    # Alpha states the withheld promise: D-065 (ADR 29534 D1) permits the
+    # publish, but D-013's stability promise and conformance claim stay
+    # withheld — experimental surfaces may change (ADR 25304 D3).
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Typing :: Typed",
+]
+
+[project.urls]
+# The mirror is the one public venue (ADR 638 D6); a published manifest never
+# names the private producer repository.
+Homepage = "https://github.com/meta-models/muse-code-sdk"
+Repository = "https://github.com/meta-models/muse-code-sdk"
+Issues = "https://github.com/meta-models/muse-code-sdk/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+muse_code = ["py.typed"]

muse_code_sdk-1.3.0/setup.cfg

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

muse_code_sdk-1.3.0/src/muse_code/__init__.py

@@ -0,0 +1,129 @@
+"""Muse Code SDK for MSP: the asyncio-first Python facade.
+
+Owning spec: ``specs/638-muse-sdk-python`` (governing ADR
+``docs/adr/638-muse-sdk-python.md``). Wire shapes are imported from the
+generated ``muse_code_msp`` package, never restated here (INV-638-01/02).
+
+S1 (the transport-less core) is in: the SS4 fold (``muse_code.fold``), the
+SS4.13 pending set (``muse_code.pending``), the transcript replay runner
+(``muse_code.replay``), and the typed error family (``muse_code.errors``).
+S2 is in: the NDJSON connection machine, the owned-process spawn path, host
+discovery, and the strict fingerprint gate (``muse_code.connection``). S3 is in:
+the asyncio facade (``muse_code.facade`` — ``MuseClient``, ``Session``,
+``Turn``) with the host-death discharge, the approval/user-input round trip,
+the SS4.8 gap splice-fill, and the sync loop-runner wrapper
+(``muse_code.sync_facade`` — ``SyncMuseClient``).
+"""
+
+from __future__ import annotations
+
+from typing import Final
+
+from .errors import (
+    GapFillFailureReason,
+    MuseForeignSessionError,
+    MuseGapFillError,
+    MuseSessionDiscardedError,
+)
+from .fold import ItemStore, SessionFold, SessionStateStore
+from .pending import PendingCommandSet
+from .replay import Transcript, load_transcript, replay_into_fold, transcript_dirs
+
+__all__ = [
+    "EXPECTED_SCHEMA_FINGERPRINT",
+    "ApprovalDecisionInput",
+    "ApprovalFailure",
+    "ApprovalFailureHandler",
+    "ApprovalHandler",
+    "DiscardedSessions",
+    "GapFillFailureHandler",
+    "GapFillFailureReason",
+    "HostDeathDischarge",
+    "HostDeathNotification",
+    "ItemStore",
+    "MuseClient",
+    "MuseClientOptions",
+    "MuseClientSpawnOptions",
+    "MuseForeignSessionError",
+    "MuseGapFillError",
+    "MuseHostDiedError",
+    "MuseSessionDiscardedError",
+    "PendingCommandSet",
+    "PendingCommandView",
+    "ResumeSessionOptions",
+    "SendUserTurnOptions",
+    "Session",
+    "SessionApplyOutcome",
+    "SessionDurabilityProfile",
+    "SessionFold",
+    "SessionFoldView",
+    "SessionGapBuffered",
+    "SessionGapOverlap",
+    "SessionStateStore",
+    "StartSessionOptions",
+    "SyncMuseClient",
+    "SyncSession",
+    "SyncTurn",
+    "Transcript",
+    "TransportEof",
+    "Turn",
+    "TurnOutcome",
+    "is_abnormal_host_death",
+    "is_launch_failure",
+    "load_transcript",
+    "read_session_durability",
+    "replay_into_fold",
+    "transcript_dirs",
+]
+
+EXPECTED_SCHEMA_FINGERPRINT: Final[str] = (
+    "sha256:ab69549a7ebb423fce94068762da0b5ff3cdec1f8fc263dcc17248eda117f852"
+)
+"""The stable schema-bundle fingerprint this SDK was built against.
+
+The one deliberately duplicated fact (spec 638 FR-638-006, the 14990 FR-006
+pattern): ``clients/sdk-py/tests/test_manifests.py`` binds it to
+``schema/msp/stable/manifest.json``, so a schema advance that forgets the
+Python SDK reds this lane instead of drifting silently.
+"""
+
+# D-063 lockstep (ADR 25304 D4): the release train bumps pyproject.toml, the
+# distribution-metadata authority; this constant is aligned at publication
+# time (the publish itself is owner-run, permitted by D-065, ADR 29534 D1).
+__version__: Final[str] = "1.3.0"
+
+# The facade is imported last so the constants above are already bound: the
+# spawn path reads ``EXPECTED_SCHEMA_FINGERPRINT`` (lazily, at initialize
+# time), and importing the facade first would risk a partially initialized
+# module.
+from .facade import (  # noqa: E402
+    ApprovalDecisionInput,
+    ApprovalFailure,
+    ApprovalFailureHandler,
+    ApprovalHandler,
+    DiscardedSessions,
+    GapFillFailureHandler,
+    HostDeathDischarge,
+    HostDeathNotification,
+    MuseClient,
+    MuseClientOptions,
+    MuseClientSpawnOptions,
+    MuseHostDiedError,
+    PendingCommandView,
+    ResumeSessionOptions,
+    SendUserTurnOptions,
+    Session,
+    SessionApplyOutcome,
+    SessionDurabilityProfile,
+    SessionFoldView,
+    SessionGapBuffered,
+    SessionGapOverlap,
+    StartSessionOptions,
+    TransportEof,
+    Turn,
+    TurnOutcome,
+    is_abnormal_host_death,
+    is_launch_failure,
+    read_session_durability,
+)
+from .sync_facade import SyncMuseClient, SyncSession, SyncTurn  # noqa: E402

muse_code_sdk-1.3.0/src/muse_code/connection/__init__.py

@@ -0,0 +1,49 @@
+"""The MSP connection plane (spec 638 FR-638-011..018): the transport-less
+NDJSON connection machine, the owned-process spawn path, and host discovery.
+"""
+
+from __future__ import annotations
+
+from .connection import (
+    Connection,
+    DuplexTransport,
+    MspError,
+    NotificationHandler,
+    Params,
+    ProtocolError,
+    ProtocolErrorHandler,
+    RetryDelay,
+    ServerRequestHandler,
+    create_uuid_v7_mint,
+)
+from .discovery import discover_muse_bin
+from .spawn import (
+    ConnectionOptions,
+    ExitClassification,
+    MspHandshake,
+    MuseServeChild,
+    ProcessExit,
+    SpawnedMspConnection,
+    spawn_msp_connection,
+)
+
+__all__ = [
+    "Connection",
+    "ConnectionOptions",
+    "DuplexTransport",
+    "ExitClassification",
+    "MspError",
+    "MspHandshake",
+    "MuseServeChild",
+    "NotificationHandler",
+    "Params",
+    "ProcessExit",
+    "ProtocolError",
+    "ProtocolErrorHandler",
+    "RetryDelay",
+    "ServerRequestHandler",
+    "SpawnedMspConnection",
+    "create_uuid_v7_mint",
+    "discover_muse_bin",
+    "spawn_msp_connection",
+]