experimental-a2 0.17.0 → 0.18.1

package/examples/playground/app/chat/server.test.ts

@@ -26,32 +26,36 @@ vi.mock('experimental-a2/ai/server', async (importActual) => {
     agent: (options: Parameters<typeof actual.agent>[0]) =>
       actual.agent({
         ...options,
-        generate: ({
-          event,
-          messages,
-        }: {
-          event: { payload: { reason: string } }
-          messages: { role: string; id: string }[]
-        }) => {
-          prompts.push(
-            messages.map((message) => `${message.role}:${message.id}`).join(),
-          )
-          return step(
-            event.payload.reason === 'message'
-              ? [
-                  { type: 'start' },
-                  ...['Hello', 'there'].map(
-                    (message, call): UIMessageChunk => ({
-                      type: 'tool-input-available',
-                      toolCallId: `call-${call}`,
-                      toolName: 'post',
-                      input: { message },
-                    }),
-                  ),
-                  { type: 'finish', finishReason: 'tool-calls' },
-                ]
-              : [{ type: 'start' }, { type: 'finish', finishReason: 'stop' }],
-          )
+        harness: {
+          ...(options.harness?.type === 'ai-sdk' ? options.harness : {}),
+          type: 'ai-sdk',
+          generate: ({
+            event,
+            messages,
+          }: {
+            event: { payload: { reason: string } }
+            messages: { role: string; id: string }[]
+          }) => {
+            prompts.push(
+              messages.map((message) => `${message.role}:${message.id}`).join(),
+            )
+            return step(
+              event.payload.reason === 'message'
+                ? [
+                    { type: 'start' },
+                    ...['Hello', 'there'].map(
+                      (message, call): UIMessageChunk => ({
+                        type: 'tool-input-available',
+                        toolCallId: `call-${call}`,
+                        toolName: 'post',
+                        input: { message },
+                      }),
+                    ),
+                    { type: 'finish', finishReason: 'tool-calls' },
+                  ]
+                : [{ type: 'start' }, { type: 'finish', finishReason: 'stop' }],
+            )
+          },
         },
       } as never),
   }

package/examples/playground/app/chat/server.ts

@@ -61,57 +61,57 @@ Sound like a sharp, relaxed person in the chat, not a customer-support bot. Matc
 Only contribute when you have something useful, relevant, or friendly to add. It is fine to stay silent or stop whenever you have nothing else to say.
 To speak, call post once for each visible chat bubble. Never communicate through ordinary assistant text because it is private and is not shown in the room.
 Use as many post calls as the moment naturally calls for. Several short messages are welcome when they create better rhythm, separate distinct thoughts, or fulfill a request for a sequence. A single message is fine too. Do not spam. After post results, continue only when another message genuinely improves the conversation.`,
-  generation: {
-    maxOutputTokens: 500,
-    temperature: 0.4,
+  harness: {
+    type: 'ai-sdk',
+    generation: {
+      maxOutputTokens: 500,
+      temperature: 0.4,
+    },
+    messageMetadata: (context) => {
+      const previous = context.messages.find(
+        (message) => message.id === context.event.payload.responseMessageId,
+      )?.metadata
+      const trigger = context.messages.find(
+        (message) => message.id === context.event.payload.messageId,
+      )?.metadata
+      const steps = previous?.kind === 'agent' ? previous.steps : []
+      const mode: ChatAgentMode | undefined =
+        previous?.kind === 'agent'
+          ? previous.mode
+          : trigger?.kind === 'participant' && trigger.mode !== 'passive'
+            ? trigger.mode
+            : undefined
+      if (mode === undefined) return undefined
+      const metadata = {
+        kind: 'agent' as const,
+        author: 'agent' as const,
+        mode,
+        steps,
+      }
+      if (context.part.type === 'start') return metadata
+      if (context.part.type !== 'finish') return undefined
+      return {
+        ...metadata,
+        steps: [
+          ...steps,
+          {
+            generationId: context.generationId,
+            model: context.model,
+            finishReason: context.part.finishReason,
+            ...(context.part.rawFinishReason === undefined
+              ? {}
+              : { rawFinishReason: context.part.rawFinishReason }),
+            usage: context.part.totalUsage,
+            completedAt: new Date().toISOString(),
+          },
+        ],
+      }
+    },
   },
   progress: {
     maxChunks: 4,
     maxDelayMs: 30,
   },
-  messageMetadata: (context) => {
-    const previous = context.messages.find(
-      (message) => message.id === context.event.payload.responseMessageId,
-    )?.metadata
-    const trigger = context.messages.find(
-      (message) => message.id === context.event.payload.messageId,
-    )?.metadata
-    const steps = previous?.kind === 'agent' ? previous.steps : []
-    const mode: ChatAgentMode | undefined =
-      previous?.kind === 'agent'
-        ? previous.mode
-        : trigger?.kind === 'participant' && trigger.mode !== 'passive'
-          ? trigger.mode
-          : undefined
-    if (mode === undefined) return undefined
-    const metadata = {
-      kind: 'agent' as const,
-      author: 'agent' as const,
-      mode,
-      steps,
-    }
-    if (context.part.type === 'start') return metadata
-    if (context.part.type !== 'finish') return undefined
-    return {
-      ...metadata,
-      steps: [
-        ...steps,
-        {
-          generationId: context.generationId,
-          model:
-            typeof context.model === 'string'
-              ? context.model
-              : context.model.modelId,
-          finishReason: context.part.finishReason,
-          ...(context.part.rawFinishReason === undefined
-            ? {}
-            : { rawFinishReason: context.part.rawFinishReason }),
-          usage: context.part.totalUsage,
-          completedAt: new Date().toISOString(),
-        },
-      ],
-    }
-  },
 })
 
 /** The room. Each message goes on to the agent's session, marked for whether it should answer. */

package/examples/playground/next.config.ts

@@ -1,10 +1,22 @@
-// No workarounds needed: experimental-a2/server is a separate server-only entry
-// point, so client bundles never reach a store backend; the sqlite dev
-// default carries its own turbopackIgnore annotation in a2's dist, so
-// output tracing stays scoped without externalizing anything; and
+// experimental-a2/server is a separate server-only entry point, so client
+// bundles never reach a store backend; the sqlite dev default carries its own
+// turbopackIgnore annotation in a2's dist, so output tracing stays scoped; and
 // Next 16 transpiles this file with the TS7 (tsgo) compiler.
 import type { NextConfig } from 'next'
 
-const nextConfig: NextConfig = {}
+const nextConfig: NextConfig = {
+  // libfx loads a native binary for the platform, falling back to its
+  // WebAssembly, by paths the bundler cannot follow; Node loads both from
+  // node_modules at runtime.
+  serverExternalPackages: ['libfx'],
+  turbopack: {
+    // WebAssembly Pi's code reaches that the bundler cannot trace.
+    resolveAlias: {
+      '@silvia-odwyer/photon-node': './app/a0/no-photon.cjs',
+      'quickjs-wasi': './app/a0/no-quickjs.cjs',
+      'quickjs-wasi/quickjs.wasm': './app/a0/no-quickjs.cjs',
+    },
+  },
+}
 
 export default nextConfig

package/examples/playground/package.json

@@ -19,6 +19,8 @@
     "@ai-sdk/otel": "1.0.58",
     "@codemirror/state": "^6.7.1",
     "@codemirror/view": "^6.43.8",
+    "@earendil-works/pi-ai": "1.0.3",
+    "@earendil-works/pi-coding-agent": "1.0.2",
     "@opentelemetry/api": "^1.9.0",
     "@vercel/functions": "^3.9.3",
     "@vercel/otel": "^2.1.0",
@@ -26,9 +28,10 @@
     "@vercel/sandbox": "^3.0.0",
     "ai": "^7.0.58",
     "codemirror": "^6.0.2",
-    "experimental-a2": "0.17.0",
+    "experimental-a2": "0.18.1",
     "geist": "^1.7.2",
     "ioredis": "^5.9.0",
+    "libfx": "0.0.12",
     "lucide-react": "^1.34.0",
     "next": "^16.3.0",
     "pg": "^8.16.0",

package/examples/playground/vercel.json

@@ -45,6 +45,24 @@
         }
       ]
     },
+    "app/a0/fx/scheduler/route.ts": {
+      "experimentalTriggers": [
+        {
+          "type": "queue/v2beta",
+          "topic": "a2-a0-fx",
+          "retryAfterSeconds": 30
+        }
+      ]
+    },
+    "app/a0/pi/scheduler/route.ts": {
+      "experimentalTriggers": [
+        {
+          "type": "queue/v2beta",
+          "topic": "a2-a0-pi",
+          "retryAfterSeconds": 30
+        }
+      ]
+    },
     "app/a0/sandboxes/scheduler/route.ts": {
       "experimentalTriggers": [
         {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "experimental-a2",
-  "version": "0.17.0",
-  "description": "Durable sync and reactions for things with a lifecycle: one event log, derived state, and live client per session.",
+  "version": "0.18.1",
+  "description": "Syncs your immutable event log, from server to browser: one contract, handlers, derived state, and a live client per session.",
   "license": "MIT",
   "type": "module",
   "sideEffects": false,
@@ -39,6 +39,14 @@
       "browser": "./dist/ai-server.browser.js",
       "default": "./dist/ai-server.js"
     },
+    "./ai/fx": {
+      "browser": "./dist/ai-fx.browser.js",
+      "default": "./dist/ai-fx.js"
+    },
+    "./ai/pi": {
+      "browser": "./dist/ai-pi.browser.js",
+      "default": "./dist/ai-pi.js"
+    },
     "./ai/client": "./dist/ai-client.js",
     "./ai/react": "./dist/ai-react.js",
     "./actor": {
@@ -61,9 +69,12 @@
   "peerDependencies": {
     "@opentelemetry/api": "^1.9.0",
     "@upstash/qstash": "^2.11.0",
+    "@earendil-works/pi-ai": "^1.0.2",
+    "@earendil-works/pi-coding-agent": "^1.0.2",
     "@vercel/queue": "*",
     "ai": "^7.0.0",
     "ioredis": "^5.4.0",
+    "libfx": "^0.0.12",
     "pg": "^8.11.0",
     "react": "^19.0.0"
   },
@@ -80,9 +91,18 @@
     "ai": {
       "optional": true
     },
+    "@earendil-works/pi-ai": {
+      "optional": true
+    },
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    },
     "ioredis": {
       "optional": true
     },
+    "libfx": {
+      "optional": true
+    },
     "pg": {
       "optional": true
     },
@@ -115,7 +135,11 @@
     "tsdown": "^0.22.14",
     "typescript": "^7.0.2",
     "vitest": "^4.1.10",
-    "zod": "^4.4.3"
+    "zod": "^4.4.3",
+    "libfx": "0.0.12",
+    "@earendil-works/pi-ai": "1.0.3",
+    "@earendil-works/pi-coding-agent": "1.0.2",
+    "@vercel/sandbox": "^3.0.0"
   },
   "scripts": {
     "build": "tsdown",