create-spatius-app 0.1.3-beta.2 → 0.1.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-spatius-app",
-  "version": "0.1.3-beta.2",
+  "version": "0.1.4",
   "description": "Create a Spatius voice-avatar app with LiveKit or Agora Conversational AI on Cloudflare Workers.",
   "type": "module",
   "bin": {
@@ -34,7 +34,7 @@
   "engines": {
     "node": ">=22"
   },
-  "packageManager": "pnpm@12.3.4",
+  "packageManager": "pnpm@12.5.1",
   "publishConfig": {
     "access": "public",
     "provenance": true
@@ -74,6 +74,6 @@
     "typescript": "^6.0.2",
     "typescript-eslint": "^8.69.0",
     "vitest": "^5.0.0",
-    "yaml": "2.9.0"
+    "yaml": "2.9.1"
   }
 }

package/templates/cloudflare-livekit/README.md

@@ -54,6 +54,16 @@ This starts the Python agent first, then starts the frontend and Cloudflare
 Worker once the agent has registered with LiveKit. If registration takes more
 than 60 seconds, startup stops with an error.
 
+Press Ctrl+C once to stop both services. If shutdown logs cover the shell prompt
+and it looks as though another Ctrl+C is required, use pnpm 12.4.1 or later for
+both the executable on your PATH and the `packageManager` pin in `package.json`.
+An older launcher or project pin can return to the shell before the services
+finish shutting down; [pnpm 12.4.1 fixes signal forwarding and waiting](https://github.com/pnpm/pnpm/releases/tag/v12.4.1).
+For a Homebrew installation, run `brew update` followed by `brew upgrade pnpm`.
+Set `packageManager` to `pnpm@12.4.1`, then run `pnpm install` to refresh the
+package-manager lock entry. Changing only the project pin leaves an older
+launcher in use; upgrading only the launcher leaves an older project pin active.
+
 ## Validate without credentials
 
 After installing both dependency sets, you can run these checks before account

package/templates/cloudflare-livekit/agent/Dockerfile.pip

@@ -21,6 +21,11 @@ ENV PATH="/app/.venv/bin:$PATH" \
     PYTHONDONTWRITEBYTECODE=1 \
     PYTHONUNBUFFERED=1
 
+# Spatius encodes outgoing avatar audio with the native Opus library.
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends libopus0 \
+    && rm -rf /var/lib/apt/lists/*
+
 RUN useradd --create-home --uid 10001 appuser
 WORKDIR /app
 
@@ -28,4 +33,7 @@ COPY --from=builder --chown=appuser:appuser /app /app
 
 USER appuser
 
+# Fail the build if the runtime cannot load the native audio encoder.
+RUN python -c "import opuslib_next"
+
 CMD ["python", "-m", "src.agent", "start"]

package/templates/cloudflare-livekit/agent/Dockerfile.uv

@@ -19,6 +19,11 @@ FROM python:${PYTHON_VERSION}-slim-bookworm
 ENV PATH="/app/.venv/bin:$PATH" \
     PYTHONUNBUFFERED=1
 
+# Spatius encodes outgoing avatar audio with the native Opus library.
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends libopus0 \
+    && rm -rf /var/lib/apt/lists/*
+
 RUN useradd --create-home --uid 10001 appuser
 WORKDIR /app
 
@@ -26,4 +31,7 @@ COPY --from=builder --chown=appuser:appuser /app /app
 
 USER appuser
 
+# Fail the build if the runtime cannot load the native audio encoder.
+RUN python -c "import opuslib_next"
+
 CMD ["python", "-m", "src.agent", "start"]

package/templates/cloudflare-livekit/agent/README.md

@@ -90,4 +90,6 @@ Use `lk agent deploy` for later releases. Keep `livekit.toml` local until you
 have reviewed the project-specific values it contains.
 
 The Docker image runs as a non-root user and downloads model support files at
-build time so startup does not need to fetch them.
+build time so startup does not need to fetch them. It also installs the native
+Opus library required for Spatius audio forwarding and checks that the Python
+binding can load it during the build.