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

package/templates/cloudflare-livekit/tests/dev-supervision.test.mjs

@@ -95,20 +95,24 @@ async function supervise(f, extraEnv) {
   return { child, done };
 }
 
-for (const [name, side, code] of [
+for (const [name, side, code, probe] of [
   ['web exits zero', 'web', '0'],
   ['web fails', 'web', '7'],
   ['agent exits zero', 'agent', '0'],
   ['agent fails', 'agent', '29'],
+  ['web exits zero after a timed-out CLI probe', 'web', '0', 'version-hang'],
 ]) {
   test(
     `root dev supervisor: ${name} stops its sibling and all grandchildren`,
     { timeout: 15000 },
     async (t) => {
-      const f = await fixture(t);
+      // Windows has only a preflight python.exe stub. Use the runnable uv shim
+      // so a slow CLI probe can fall back without exiting before registration.
+      const f = await fixture(t, { uv: windows || Boolean(probe) });
       const run = await supervise(f, {
         DEV_TEST_RUNTIME_HOLD: '1',
         DEV_TEST_GRANDCHILD: '1',
+        ...(probe ? { DEV_TEST_PROBE: probe } : {}),
         ...(side === 'web'
           ? { DEV_TEST_WEB_EXIT: code }
           : { DEV_TEST_EXIT_WHEN_RELEASED: '1', DEV_TEST_RUNTIME_EXIT: code }),
@@ -130,15 +134,14 @@ for (const [name, side, code] of [
       await assertStopped(events.map(({ pid }) => pid));
       // A bounded CLI probe may select Python fallback on a busy machine.
       // Supervision must launch exactly one runtime through either supported path.
-      assert.equal(
-        (await readEvents(f.events)).filter(
-          ({ role, args, type }) =>
-            ['lk', 'uv', 'python'].includes(role) &&
-            type === 'invoked' &&
-            args.includes('src/agent.py'),
-        ).length,
-        1,
+      const runtimes = (await readEvents(f.events)).filter(
+        ({ role, args, type }) =>
+          ['lk', 'uv', 'python'].includes(role) &&
+          type === 'invoked' &&
+          args.includes('src/agent.py'),
       );
+      assert.equal(runtimes.length, 1);
+      if (probe) assert.equal(runtimes[0].role, 'uv');
     },
   );
 }
@@ -152,7 +155,7 @@ test(
       'Node cannot send console Ctrl+C events on Windows; taskkill tree cleanup is tested separately.',
   },
   async (t) => {
-    const f = await fixture(t);
+    const f = await fixture(t, { uv: windows });
     const run = await supervise(f, {
       DEV_TEST_RUNTIME_HOLD: '1',
       DEV_TEST_GRANDCHILD: '1',
@@ -252,7 +255,7 @@ test(
   'agent failure before registration never starts web',
   { timeout: 15000 },
   async (t) => {
-    const f = await fixture(t);
+    const f = await fixture(t, { uv: windows });
     const run = await supervise(f, { DEV_TEST_RUNTIME_EXIT: '29' });
     const result = await run.done;
     assert.notEqual(result.code, 0);
@@ -265,7 +268,7 @@ test(
   'registration timeout stops the agent without starting web',
   { timeout: 15000 },
   async (t) => {
-    const f = await fixture(t);
+    const f = await fixture(t, { uv: windows });
     // Accelerate only the copied fixture's deadline; exercise the real web gate.
     const path = join(f.root, 'scripts', 'wait-for-agent.mjs');
     await writeFile(
@@ -290,7 +293,7 @@ test(
   'Ctrl+C while waiting for registration stops the agent without starting web',
   { timeout: 15000, skip: windows },
   async (t) => {
-    const f = await fixture(t);
+    const f = await fixture(t, { uv: windows });
     const run = await supervise(f, {
       DEV_TEST_RUNTIME_HOLD: '1',
       DEV_TEST_REGISTER: join(f.root, 'never-register'),

package/templates/layers/agora/AGENTS.md

@@ -1,8 +1,13 @@
 # Generated Agora application
 
 Use `__DEV__` for local development and `__CHECK__` for verification.
-The Node backend calls hosted Conversational AI over HTTP; do not add a Python
-worker. Browser audio uses Agora RTC, text input and transcripts use the official
+The Cloudflare Worker API calls hosted Conversational AI over HTTP. Agora owns
+the conversational agent; this application has no Python worker or Node server.
+Browser audio uses Agora RTC, and text input and transcripts use the official
 Agora client toolkit. Spatius renders the avatar locally.
-Keep secrets in .env.local or deployment environment variables. Preserve session
-cleanup on disconnect and failed startup. See DEPLOYMENT.md for Zeabur setup.
+
+Keep secrets in `.dev.vars` locally and Cloudflare Worker secrets in production.
+Wrangler generates the ignored `worker-configuration.d.ts` during installation
+and before lint, type checking, and builds. Update `wrangler.jsonc` to change bindings.
+Preserve session cleanup on disconnect and failed startup.
+Use mocks for provider calls in tests. See DEPLOYMENT.md for Cloudflare setup.

package/templates/layers/agora/README.md

@@ -1,6 +1,9 @@
-# Spatius voice assistant — Zeabur + Agora
+# Spatius voice assistant — Cloudflare + Agora
+
+A minimal React avatar conversation with a Cloudflare Worker API and Agora
+Conversational AI. The frontend and API deploy together on Cloudflare Workers;
+Agora hosts the conversational agent.
 
-A minimal React avatar conversation with an HTTP backend and Agora Conversational AI.
 Requires Node.js 22.12+, an Agora project with Conversational AI and RTM enabled,
 a published English assistant pipeline, and Spatius credentials. No Python is needed.
 
@@ -10,10 +13,13 @@ npx create-spatius-app setup . --interactive
 __DEV__
 ```
 
-Open the Vite URL, start a conversation, and speak or type. Microphone permission
-is optional: typed messages go to the model through Agora RTM. The transcript
-stays visible after disconnecting. Configure the assistant persona, speech
-recognition language, model, and voice in the published Agora pipeline. Match
-AGORA_AVATAR_SAMPLE_RATE to that pipeline's TTS output.
+Local setup saves credentials in `.dev.vars`. The Vite Cloudflare plugin runs
+both the frontend and Worker API locally. Open the printed URL, start a
+conversation, and speak or type. Microphone permission is optional: typed
+messages use Agora RTM. The transcript stays visible after disconnecting.
+
+Configure the assistant persona, speech recognition language, model, and voice
+in the published Agora pipeline. Match `AGORA_AVATAR_SAMPLE_RATE` to its TTS output.
 
-See DEPLOYMENT.md to deploy the frontend and API together to Zeabur.
+Run `__CHECK__` to verify the application. See [DEPLOYMENT.md](DEPLOYMENT.md)
+to deploy the frontend and API together to Cloudflare Workers.