build,ci: rename PyPI dist to murmur-runtime, scope js-client to @Murmur, scope release to PyPI only

PyPI rejected ``murmur-ai`` as too similar to existing projects
(``murmur`` the hash library, ``murmurai`` the transcription API).
Rename:

  - PyPI distribution: ``murmur-ai`` → ``murmur-runtime``. The Python
    import name stays ``murmur`` (distribution name and import name are
    independent); only ``pip install`` changes.
  - npm scope: ``@murmur-ai`` → ``@murmur`` (the package becomes
    ``@murmur/client``). Aligns the brand on npm without depending on
    PyPI's exact name.

Sweep every reference in README, docs, CLAUDE.md, examples, RELEASING,
and the JS client package metadata. The repo (``droidnoob/murmur-ai``)
and the Pages URL (``droidnoob.github.io/murmur-ai/``) keep their
existing names — they're tied to the GitHub repo, not the package.

Trim ``release.yml`` to publish only ``murmur-runtime`` on the first
release. ``murmur-client`` (PyPI) and ``@murmur/client`` (npm) need
their pending-publisher / npm-token + scope set up before the workflow
can publish them; add those jobs back once that's in place.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: droidnoob

.github/workflows/release.yml

@@ -1,15 +1,15 @@
 name: release
 
 # Tag-triggered release. Push ``vX.Y.Z`` and this workflow:
-#   1. Builds + publishes ``murmur-ai`` and ``murmur-client`` to PyPI
-#      (Trusted Publishing via OIDC — no tokens).
-#   2. Builds + publishes ``@murmur-ai/client`` to npm (uses NPM_TOKEN).
-#   3. Creates a GitHub Release with auto-generated notes from commits
+#   1. Builds + publishes ``murmur-runtime`` to PyPI (Trusted Publishing
+#      via OIDC — no tokens).
+#   2. Creates a GitHub Release with auto-generated notes from commits
 #      since the previous tag.
 #
-# All three packages must already report the same ``X.Y.Z`` as the tag —
-# the verification step below fails fast otherwise so you don't ship a
-# version mismatch.
+# ``murmur-client`` (PyPI) and ``@murmur/client`` (npm) ship from this
+# repo too, but are not yet wired into the release pipeline. Add their
+# build + publish steps once their first publish is unblocked
+# (PyPI pending publisher entry / npm token + scope).
 
 on:
   push:
@@ -27,7 +27,7 @@ concurrency:
 jobs:
   # --------------------------------------------------------------- verify
   # Fail fast if the tag and the in-tree versions disagree. Cheaper to
-  # catch here than mid-publish.
+  # catch here than mid-publish. Only checks files we publish from.
   verify:
     runs-on: ubuntu-latest
     outputs:
@@ -44,20 +44,11 @@ jobs:
           echo "version=${version}" >> "$GITHUB_OUTPUT"
           echo "Tag → ${tag}, version → ${version}"
 
-      - name: Verify pyproject.toml versions match
+      - name: Verify pyproject.toml version matches
         run: |
           v="${{ steps.parse.outputs.version }}"
-          for f in pyproject.toml packages/murmur-client/pyproject.toml; do
-            grep -E "^version = \"${v}\"" "$f" \
-              || { echo "::error::${f} does not declare version ${v}"; exit 1; }
-          done
-
-      - name: Verify package.json version matches
-        run: |
-          v="${{ steps.parse.outputs.version }}"
-          jq -e --arg v "$v" '.version == $v' \
-            packages/js-client/package.json \
-            || { echo "::error::js-client/package.json does not declare ${v}"; exit 1; }
+          grep -E "^version = \"${v}\"" pyproject.toml \
+            || { echo "::error::pyproject.toml does not declare version ${v}"; exit 1; }
 
       - name: Verify __version__ matches
         run: |
@@ -77,60 +68,15 @@ jobs:
         with:
           enable-cache: true
 
-      - name: Build murmur-ai
-        run: uv build --out-dir dist-murmur-ai
+      - name: Build murmur-runtime
+        run: uv build --out-dir dist
 
-      - name: Build murmur-client
-        run: uv build --out-dir dist-murmur-client packages/murmur-client
-
-      - name: Publish murmur-ai
+      - name: Publish murmur-runtime
         uses: pypa/gh-action-pypi-publish@release/v1
-        with:
-          packages-dir: dist-murmur-ai
-
-      - name: Publish murmur-client
-        uses: pypa/gh-action-pypi-publish@release/v1
-        with:
-          packages-dir: dist-murmur-client
-
-  # ----------------------------------------------------------------- npm
-  npm:
-    needs: verify
-    runs-on: ubuntu-latest
-    defaults:
-      run:
-        working-directory: packages/js-client
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-          registry-url: 'https://registry.npmjs.org'
-
-      - name: Install
-        run: npm ci || npm install
-
-      - name: Typecheck
-        run: npm run typecheck
-
-      - name: Test
-        run: npm test
-
-      - name: Build
-        run: npm run build
-
-      - name: Publish
-        # ``--access public`` is required for the first publish of a
-        # scoped package (``@murmur-ai/...``) — scoped packages default
-        # to private otherwise. Idempotent on subsequent publishes.
-        run: npm publish --access public --provenance
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 
   # -------------------------------------------------------- github release
   github-release:
-    needs: [pypi, npm]
+    needs: pypi
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4

AGENTS.md

@@ -14,7 +14,7 @@ It is **not** a framework for defining agent behavior. It is **infrastructure**
 
 PydanticAI handles single-agent execution (LLM calls, tools, structured output, validation). FastStream handles broker-backed distribution. Murmur owns the orchestration layer between them — and **hides both behind its own public API.**
 
-Repository: `murmur-ai` · PyPI distribution: `murmur-ai` · Import package: `murmur`.
+Repository: `murmur-runtime` · PyPI distribution: `murmur-runtime` · Import package: `murmur`.
 
 ---
 
@@ -443,14 +443,14 @@ structlog ← logging
 ### Broker extras
 
 ```
-murmur-ai[kafka]      → faststream[kafka]
-murmur-ai[nats]       → faststream[nats]
-murmur-ai[rabbitmq]   → faststream[rabbit]
-murmur-ai[redis]      → faststream[redis]
-murmur-ai[all]        → all brokers
+murmur-runtime[kafka]      → faststream[kafka]
+murmur-runtime[nats]       → faststream[nats]
+murmur-runtime[rabbitmq]   → faststream[rabbit]
+murmur-runtime[redis]      → faststream[redis]
+murmur-runtime[all]        → all brokers
 ```
 
-ThreadBackend has no broker dep — `pip install murmur-ai` works out of the box.
+ThreadBackend has no broker dep — `pip install murmur-runtime` works out of the box.
 
 ---
 

CHANGELOG.md

@@ -108,7 +108,7 @@ shipped yet (`0.0.0` placeholder). Highlights since project inception:
 
 ### Added — packaging
 
-- Workspace layout: `murmur-ai` (this) + `murmur-client` (separate wheel).
+- Workspace layout: `murmur-runtime` (this) + `murmur-client` (separate wheel).
 - Optional extras: `[kafka]`, `[nats]`, `[rabbitmq]`, `[redis]`, `[all]`,
   `[server]`, `[sqlite]`, `[rocksdb]`, `[redis-runstore]`, `[container]`,
   `[docs]`.
@@ -121,4 +121,4 @@ shipped yet (`0.0.0` placeholder). Highlights since project inception:
 - GitHub Pages workflow at `.github/workflows/docs.yml` using
   `actions/upload-pages-artifact@v3` + `actions/deploy-pages@v4`.
 
-[Unreleased]: https://github.com/murmur-ai/murmur/commits/main
+[Unreleased]: https://github.com/murmur-runtime/murmur/commits/main

CLAUDE.md

@@ -14,7 +14,7 @@ It is **not** a framework for defining agent behavior. It is **infrastructure**
 
 PydanticAI handles single-agent execution (LLM calls, tools, structured output, validation). FastStream handles broker-backed distribution. Murmur owns the orchestration layer between them — and **hides both behind its own public API.**
 
-Repository: `murmur-ai` · PyPI distribution: `murmur-ai` · Import package: `murmur`.
+Repository: `murmur-runtime` · PyPI distribution: `murmur-runtime` · Import package: `murmur`.
 
 ---
 
@@ -443,14 +443,14 @@ structlog ← logging
 ### Broker extras
 
 ```
-murmur-ai[kafka]      → faststream[kafka]
-murmur-ai[nats]       → faststream[nats]
-murmur-ai[rabbitmq]   → faststream[rabbit]
-murmur-ai[redis]      → faststream[redis]
-murmur-ai[all]        → all brokers
+murmur-runtime[kafka]      → faststream[kafka]
+murmur-runtime[nats]       → faststream[nats]
+murmur-runtime[rabbitmq]   → faststream[rabbit]
+murmur-runtime[redis]      → faststream[redis]
+murmur-runtime[all]        → all brokers
 ```
 
-ThreadBackend has no broker dep — `pip install murmur-ai` works out of the box.
+ThreadBackend has no broker dep — `pip install murmur-runtime` works out of the box.
 
 ---
 

CONTRIBUTING.md

@@ -12,7 +12,7 @@ opening a PR.
 ## Local setup
 
 ```bash
-git clone https://github.com/murmur-ai/murmur && cd murmur
+git clone https://github.com/murmur-runtime/murmur && cd murmur
 uv sync --group dev                      # core deps + dev tools
 uv run pre-commit install                # one-time per clone
 uv run pytest -m "not integration" -q    # 556 unit tests

README.md

@@ -9,7 +9,7 @@
 [![Python](https://img.shields.io/badge/python-3.11%20%7C%203.12%20%7C%203.13-blue)](https://www.python.org/downloads/)
 [![pydantic-ai](https://img.shields.io/badge/pydantic--ai-1.87-purple)](https://ai.pydantic.dev/)
 [![FastStream](https://img.shields.io/badge/faststream-0.6-orange)](https://faststream.ag2.ai/latest/)
-[![PyPI](https://img.shields.io/badge/pypi-murmur--ai-blueviolet)](https://pypi.org/project/murmur-ai/)
+[![PyPI](https://img.shields.io/badge/pypi-murmur--ai-blueviolet)](https://pypi.org/project/murmur-runtime/)
 [![Docs](https://img.shields.io/badge/docs-droidnoob.github.io-blue)](https://droidnoob.github.io/murmur-ai/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
 
@@ -45,7 +45,7 @@ The same code runs locally on `asyncio` or distributed across a worker fleet on
 
 - **Observable by default.** Every spawn, completion, tool call, group start/end, worker lifecycle, and budget hit emits a typed `RuntimeEvent`. Composable emitters: `LogEventEmitter` (structlog), `SSEEventEmitter` (HTTP streaming), `MultiEventEmitter` (fan-out), `BrokerEventBridge` (worker → publisher relay). Every event carries `agent_name`, `task_id`, `trace_id`, `parent_trace_id`, `timestamp`.
 
-- **OpenTelemetry metrics export.** Drop-in `OTelMetricsEmitter` records `gen_ai.client.token.usage` and `gen_ai.client.operation.duration` histograms per the OTel GenAI semantic conventions, plus Murmur's own tool-call and rejection counters. Cardinality-safe attributes; your `MeterProvider` decides where the data lands (Datadog, Grafana, Logfire, Phoenix). Opt-in via `murmur-ai[otel]`.
+- **OpenTelemetry metrics export.** Drop-in `OTelMetricsEmitter` records `gen_ai.client.token.usage` and `gen_ai.client.operation.duration` histograms per the OTel GenAI semantic conventions, plus Murmur's own tool-call and rejection counters. Cardinality-safe attributes; your `MeterProvider` decides where the data lands (Datadog, Grafana, Logfire, Phoenix). Opt-in via `murmur-runtime[otel]`.
 
 - **Cost-aware orchestration.** `TokenBudget` enforces per-task and per-runtime token ceilings with pre-check + post-charge semantics. Budgets propagate through cascading spawns; over-budget runs raise the typed `BudgetExceededError`. Best-effort USD costs computed from per-model rate cards.
 
@@ -95,33 +95,33 @@ Null → Full → Summary → Selective   (Summary / Selective planned)
 ## Install
 
 ```bash
-pip install murmur-ai            # AsyncBackend, no broker — works immediately
+pip install murmur-runtime            # AsyncBackend, no broker — works immediately
 ```
 
 Or with [`uv`](https://github.com/astral-sh/uv):
 
 ```bash
-uv add murmur-ai
+uv add murmur-runtime
 ```
 
 Optional extras:
 
 | Extra | Pulls in | When |
 |---|---|---|
-| `murmur-ai[redis]` | `faststream[redis]` | Redis Streams broker |
-| `murmur-ai[kafka]` | `faststream[kafka]` | Kafka broker |
-| `murmur-ai[nats]` | `faststream[nats]` | NATS broker |
-| `murmur-ai[rabbitmq]` | `faststream[rabbit]` | RabbitMQ broker |
-| `murmur-ai[all-brokers]` | All four brokers | Multi-broker fleet |
-| `murmur-ai[server]` | `fastapi`, `uvicorn`, `sse-starlette` | `murmur serve` HTTP API |
-| `murmur-ai[otel]` | `opentelemetry-api`, `opentelemetry-sdk` | OTel metrics export |
-| `murmur-ai[mcp-server]` | `mcp` | Expose as an MCP server |
-| `murmur-ai[sqlite]` | `aiosqlite` | Persistent `RunStore` / `EventStore` |
-| `murmur-ai[redis-runstore]` | `redis` | Cluster-wide `RunStore` |
-| `murmur-ai[rocksdb]` | `rocksdict` | High-throughput single-host store |
-| `murmur-ai[uvloop]` | `uvloop` | Faster async event loop (POSIX only) |
-| `murmur-ai[reload]` | `watchfiles` | `--reload` for serve / worker |
-| `murmur-ai[all]` | Every optional extra | Kitchen-sink install |
+| `murmur-runtime[redis]` | `faststream[redis]` | Redis Streams broker |
+| `murmur-runtime[kafka]` | `faststream[kafka]` | Kafka broker |
+| `murmur-runtime[nats]` | `faststream[nats]` | NATS broker |
+| `murmur-runtime[rabbitmq]` | `faststream[rabbit]` | RabbitMQ broker |
+| `murmur-runtime[all-brokers]` | All four brokers | Multi-broker fleet |
+| `murmur-runtime[server]` | `fastapi`, `uvicorn`, `sse-starlette` | `murmur serve` HTTP API |
+| `murmur-runtime[otel]` | `opentelemetry-api`, `opentelemetry-sdk` | OTel metrics export |
+| `murmur-runtime[mcp-server]` | `mcp` | Expose as an MCP server |
+| `murmur-runtime[sqlite]` | `aiosqlite` | Persistent `RunStore` / `EventStore` |
+| `murmur-runtime[redis-runstore]` | `redis` | Cluster-wide `RunStore` |
+| `murmur-runtime[rocksdb]` | `rocksdict` | High-throughput single-host store |
+| `murmur-runtime[uvloop]` | `uvloop` | Faster async event loop (POSIX only) |
+| `murmur-runtime[reload]` | `watchfiles` | `--reload` for serve / worker |
+| `murmur-runtime[all]` | Every optional extra | Kitchen-sink install |
 
 ## Example
 
@@ -329,7 +329,7 @@ docs/                  # mkdocs site (concepts, guides, API ref)
 tests/
 ```
 
-PyPI distribution: `murmur-ai`. Import: `murmur` (`pip install murmur-ai` → `import murmur`).
+PyPI distribution: `murmur-runtime`. Import: `murmur` (`pip install murmur-runtime` → `import murmur`).
 
 The dependency arrow points inward to `core/` and `types.py`. Only `murmur.interop` may import `pydantic_ai` or `faststream`.
 

RELEASING.md

@@ -4,9 +4,9 @@ Releases ship three artifacts off one git tag:
 
 | Artifact | Registry |
 |---|---|
-| `murmur-ai` | [PyPI](https://pypi.org/project/murmur-ai/) |
+| `murmur-runtime` | [PyPI](https://pypi.org/project/murmur-runtime/) |
 | `murmur-client` | [PyPI](https://pypi.org/project/murmur-client/) |
-| `@murmur-ai/client` | [npm](https://www.npmjs.com/package/@murmur-ai/client) |
+| `@murmur/client` | [npm](https://www.npmjs.com/package/@murmur/client) |
 
 The whole pipeline runs from `.github/workflows/release.yml` on a `v*` tag push.
 
@@ -21,18 +21,18 @@ Add a Trusted Publisher entry on PyPI for each project. PyPI
 verifies the GitHub OIDC token at publish time — no long-lived
 credentials live in the repo.
 
-For both `murmur-ai` and `murmur-client`, register a publisher at:
+For both `murmur-runtime` and `murmur-client`, register a publisher at:
 
-- `https://pypi.org/manage/project/murmur-ai/settings/publishing/`
+- `https://pypi.org/manage/project/murmur-runtime/settings/publishing/`
 - `https://pypi.org/manage/project/murmur-client/settings/publishing/`
 
 Use these values:
 
 | Field | Value |
 |---|---|
-| PyPI Project Name | `murmur-ai` / `murmur-client` |
+| PyPI Project Name | `murmur-runtime` / `murmur-client` |
 | Owner | `droidnoob` |
-| Repository name | `murmur-ai` |
+| Repository name | `murmur-runtime` |
 | Workflow name | `release.yml` |
 | Environment name | `pypi` |
 
@@ -62,7 +62,7 @@ trusted publishing).
    - Value: the token
 
 The first publish needs `--access public` (the workflow passes it
-automatically; required because `@murmur-ai/...` is a scoped package
+automatically; required because `@murmur/...` is a scoped package
 and scoped packages default to private).
 
 ## Cutting a release
@@ -93,10 +93,10 @@ mismatched release.
 After the tag push, the workflow:
 
 1. **`verify`** — confirms tag and in-tree versions agree.
-2. **`pypi`** — builds + publishes `murmur-ai` and `murmur-client`
+2. **`pypi`** — builds + publishes `murmur-runtime` and `murmur-client`
    (Trusted Publishing OIDC).
 3. **`npm`** — typechecks, tests, builds, publishes
-   `@murmur-ai/client` with provenance.
+   `@murmur/client` with provenance.
 4. **`github-release`** — creates a GitHub Release with auto-generated
    notes pulled from commit subjects since the previous tag.