@agent-native/core 0.79.19 → 0.79.21

package/corpus/README.md

@@ -28,4 +28,4 @@ rg -n "defineAction|useActionQuery" node_modules/@agent-native/core/corpus
 ## Generated Counts
 
 - core files: 2031
-- template files: 4416
+- template files: 4423

package/corpus/core/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @agent-native/core
 
+## 0.79.21
+
+### Patch Changes
+
+- 3acd677: Clarify workspace Docker Compose deployment for self-hosted VPS installs.
+
+## 0.79.20
+
+### Patch Changes
+
+- 8bcc21d: Declare the Sentry OpenTelemetry trace dependency directly so the published CLI installs reliably through npx.
+- 8bcc21d: Use a compact popover for the shared language picker so icon-only chrome can style it reliably.
+
 ## 0.79.19
 
 ### Patch Changes

package/corpus/core/docs/content/deployment.md

@@ -66,6 +66,139 @@ background processors. Local `--build-only` artifact checks still run without it
 
 Per-app independent deploy is still supported — just `cd apps/<name> && npx @agent-native/core@latest build` like a standalone scaffold.
 
+### Self-hosted workspace with Docker Compose {#workspace-docker-compose}
+
+The Dockerfile above is for one standalone app. A workspace is not one Nitro
+server process today: each app still builds to its own `.output/` directory and
+runs its own Node/Nitro server. For a VPS, run one container per workspace app,
+point every app at the same Postgres database and shared production secrets, and
+put a reverse proxy in front that routes path prefixes (`/mail`, `/calendar`,
+...) to the matching app container.
+
+Build each app with the same base path that the proxy will use at runtime. The
+base path is a build-time input for the client bundle and a runtime input for
+the server:
+
+```bash
+APP_BASE_PATH=/mail VITE_APP_BASE_PATH=/mail npx @agent-native/core@latest build
+node .output/server/index.mjs
+```
+
+A reusable workspace Dockerfile can take the app name and path prefix as build
+arguments:
+
+```dockerfile
+FROM node:24-slim AS build
+WORKDIR /workspace
+RUN corepack enable
+COPY package.json pnpm-lock.yaml pnpm-workspace.yaml ./
+COPY packages ./packages
+COPY apps ./apps
+ARG APP_NAME
+ARG APP_BASE_PATH
+ENV APP_BASE_PATH=$APP_BASE_PATH
+ENV VITE_APP_BASE_PATH=$APP_BASE_PATH
+RUN pnpm install --frozen-lockfile
+RUN pnpm --dir apps/$APP_NAME build
+
+FROM node:24-slim
+WORKDIR /app
+ARG APP_NAME
+ARG APP_BASE_PATH
+ENV NODE_ENV=production
+ENV PORT=3000
+ENV APP_BASE_PATH=$APP_BASE_PATH
+COPY --from=build /workspace/apps/$APP_NAME/.output .output
+EXPOSE 3000
+CMD ["node", ".output/server/index.mjs"]
+```
+
+Then compose Postgres, the app containers, and your proxy. This example uses
+Caddy because it can terminate HTTP locally or sit behind Cloudflare's SSL
+proxy, but the important part is the path-prefix routing:
+
+```yaml
+services:
+  postgres:
+    image: postgres:17
+    restart: unless-stopped
+    environment:
+      POSTGRES_DB: agent_native
+      POSTGRES_USER: agent_native
+      POSTGRES_PASSWORD: change-me
+    volumes:
+      - postgres-data:/var/lib/postgresql/data
+
+  mail:
+    build:
+      context: .
+      dockerfile: Dockerfile.workspace-app
+      args:
+        APP_NAME: mail
+        APP_BASE_PATH: /mail
+    restart: unless-stopped
+    environment:
+      DATABASE_URL: postgres://agent_native:change-me@postgres:5432/agent_native
+      BETTER_AUTH_URL: https://agents.example.com/mail
+      BETTER_AUTH_SECRET: ${BETTER_AUTH_SECRET}
+      A2A_SECRET: ${A2A_SECRET}
+      ANTHROPIC_API_KEY: ${ANTHROPIC_API_KEY}
+    depends_on:
+      - postgres
+
+  calendar:
+    build:
+      context: .
+      dockerfile: Dockerfile.workspace-app
+      args:
+        APP_NAME: calendar
+        APP_BASE_PATH: /calendar
+    restart: unless-stopped
+    environment:
+      DATABASE_URL: postgres://agent_native:change-me@postgres:5432/agent_native
+      BETTER_AUTH_URL: https://agents.example.com/calendar
+      BETTER_AUTH_SECRET: ${BETTER_AUTH_SECRET}
+      A2A_SECRET: ${A2A_SECRET}
+      ANTHROPIC_API_KEY: ${ANTHROPIC_API_KEY}
+    depends_on:
+      - postgres
+
+  proxy:
+    image: caddy:2
+    restart: unless-stopped
+    ports:
+      - "80:80"
+      - "443:443"
+    volumes:
+      - ./Caddyfile:/etc/caddy/Caddyfile:ro
+    depends_on:
+      - mail
+      - calendar
+
+volumes:
+  postgres-data:
+```
+
+```caddyfile
+agents.example.com {
+  reverse_proxy /mail* mail:3000
+  reverse_proxy /calendar* calendar:3000
+}
+```
+
+Notes for this shape:
+
+- Keep `DATABASE_URL`, `BETTER_AUTH_SECRET`, `A2A_SECRET`, and other production
+  secrets identical across app containers when you want shared auth, shared
+  credentials, and cross-app A2A.
+- Set `BETTER_AUTH_URL` to the public URL for that app path. OAuth callback URLs
+  should use the same public URL.
+- Do not rely on the container filesystem for production data; use Postgres (or
+  another persistent SQL backend) for `DATABASE_URL`.
+- If Cloudflare terminates TLS in front of the VPS, configure Cloudflare to send
+  normal `X-Forwarded-Proto` / `X-Forwarded-Host` headers and route the public
+  host to the proxy container.
+
 ## How It Works {#how-it-works}
 
 When you run `npx @agent-native/core@latest build`, Nitro builds both the client SPA and the server API into `.output/`:

package/corpus/core/docs/content/multi-app-workspace.md

@@ -289,6 +289,8 @@ These settings only affect read-only page navigation. Framework tools, agent cha
 
 Prefer each app on its own domain (`mail.company.com`, `calendar.company.com`)? Every app in the workspace is still an independent deployable — `cd apps/mail && npx @agent-native/core@latest build` behaves exactly like a standalone scaffold. Cross-app A2A then goes through the standard JWT-signed path with a shared `A2A_SECRET`. Cross-domain SSO between separately-deployed apps is handled by identity federation with Dispatch as the hub — see [Cross-App SSO](/docs/cross-app-sso); the unified single-origin deploy avoids needing it.
 
+For a self-hosted VPS or Docker Compose setup on one origin, build and run one container per app with its own path prefix (`APP_BASE_PATH=/mail`, `APP_BASE_PATH=/calendar`, ...), then route those prefixes through a reverse proxy. See [Deployment — Self-hosted workspace with Docker Compose](/docs/deployment#workspace-docker-compose) for the Dockerfile and compose example.
+
 ### Shared database, shared credentials
 
 Whatever you pick, point every app at the same `DATABASE_URL` for cross-app state out of the box: one set of user accounts, one set of organizations, one set of shared settings. If each app has its own database, the workspace pattern still works — you just lose that shared-state story.

package/corpus/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.79.19",
+  "version": "0.79.21",
   "description": "Framework for agent-native application development — where AI agents and UI share SQL state, actions, and context",
   "homepage": "https://github.com/BuilderIO/agent-native#readme",
   "bugs": {
@@ -204,6 +204,7 @@
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@mozilla/readability": "0.6.0",
     "@neondatabase/serverless": "^1.1.0",
+    "@opentelemetry/sdk-trace-base": "^2.8.0",
     "@radix-ui/react-dialog": "1.1.15",
     "@radix-ui/react-dropdown-menu": "^2.1.16",
     "@radix-ui/react-hover-card": "^1.1.15",

package/corpus/templates/analytics/app/components/layout/MobileNav.tsx

@@ -1,5 +1,5 @@
 import { useT } from "@agent-native/core/client";
-import { IconMenu, IconChartBar } from "@tabler/icons-react";
+import { IconMenu } from "@tabler/icons-react";
 import { useState, useEffect } from "react";
 import { useLocation } from "react-router";
 
@@ -18,7 +18,7 @@ export function MobileNav() {
   }, [location.pathname]);
 
   return (
-    <div className="flex h-12 shrink-0 items-center border-b border-border bg-sidebar px-4 md:hidden">
+    <div className="flex h-12 shrink-0 items-center border-b border-border bg-background px-4 md:hidden">
       <button
         onClick={() => setOpen(true)}
         className="me-3 p-2.5 -ms-1 rounded-md hover:bg-sidebar-accent/50"
@@ -26,14 +26,9 @@ export function MobileNav() {
       >
         <IconMenu className="h-5 w-5 text-foreground" />
       </button>
-      <div className="flex items-center gap-2">
-        <div className="flex h-7 w-7 items-center justify-center rounded-lg bg-primary text-primary-foreground">
-          <IconChartBar className="h-4 w-4" />
-        </div>
-        <span className="text-base font-bold tracking-tight">
-          {t("navigation.brand")}
-        </span>
-      </div>
+      <span className="text-base font-bold tracking-tight">
+        {t("navigation.brand")}
+      </span>
 
       <Sheet open={open} onOpenChange={setOpen}>
         <SheetContent side="left" className="p-0 w-[280px]">

package/corpus/templates/analytics/changelog/2026-06-27-mobile-navigation-chrome-and-motion.md

@@ -0,0 +1,5 @@
+---
+type: improved
+date: 2026-06-27
+---
+Improved mobile navigation chrome and sidebar drawer motion.

package/corpus/templates/assets/app/components/layout/Layout.tsx

@@ -87,7 +87,7 @@ export function Layout({ children }: LayoutProps) {
       )}
       <div
         className={cn(
-          "agent-layout-left-drawer fixed inset-y-0 start-0 z-50 md:static md:z-auto",
+          "agent-layout-left-drawer fixed inset-y-0 start-0 z-50 transition-transform duration-200 ease-out md:static md:z-auto md:transition-none",
           mobileSidebarOpen
             ? "translate-x-0"
             : "-translate-x-full md:translate-x-0",

package/corpus/templates/assets/changelog/2026-06-27-mobile-navigation-chrome-and-motion.md

@@ -0,0 +1,5 @@
+---
+type: improved
+date: 2026-06-27
+---
+Improved mobile navigation chrome and sidebar drawer motion.

package/corpus/templates/clips/app/components/recorder/pre-record-panel.tsx

@@ -41,6 +41,7 @@ import {
   SelectValue,
 } from "@/components/ui/select";
 import { Switch } from "@/components/ui/switch";
+import { useIsMobile } from "@/hooks/use-mobile";
 import {
   loadRecorderPreferences,
   saveRecorderPreferences,
@@ -192,6 +193,7 @@ export function PreRecordPanel({
     error: null,
     hasPreview: false,
   });
+  const isMobile = useIsMobile();
 
   const modeOptions = useMemo<ModeOption[]>(
     () => [
@@ -213,6 +215,14 @@ export function PreRecordPanel({
     ],
     [t],
   );
+  const visibleModeOptions = useMemo(
+    () =>
+      isMobile
+        ? modeOptions.filter((option) => option.value === "camera")
+        : modeOptions,
+    [isMobile, modeOptions],
+  );
+
   const surfaceOptions = useMemo<SurfaceOption[]>(
     () => [
       {
@@ -238,8 +248,14 @@ export function PreRecordPanel({
   );
 
   useEffect(() => {
+    if (isMobile) {
+      // Mobile browsers do not support the screen-capture choices this panel
+      // offers on desktop, so keep the setup focused on recording face video.
+      setMode("camera");
+      return;
+    }
     if (initialMode) setMode(initialMode);
-  }, [initialMode]);
+  }, [initialMode, isMobile]);
 
   useEffect(() => {
     if (initialDisplaySurface) setDisplaySurface(initialDisplaySurface);
@@ -586,7 +602,7 @@ export function PreRecordPanel({
     <div className="mx-auto w-full max-w-lg overflow-hidden rounded-2xl border border-border bg-card shadow-lg">
       <div className="p-6">
         <div className="grid gap-2 sm:grid-cols-3">
-          {modeOptions.map((opt) => {
+          {visibleModeOptions.map((opt) => {
             const Icon = opt.icon;
             const active = opt.value === mode;
             return (
@@ -600,7 +616,7 @@ export function PreRecordPanel({
                 className={cn(
                   "flex min-h-20 min-w-0 flex-col justify-between rounded-xl border p-3 text-start transition-colors",
                   active
-                    ? "border-primary bg-primary text-primary-foreground shadow-sm"
+                    ? "border-primary/55 bg-primary/[0.12] text-foreground shadow-sm ring-1 ring-primary/15"
                     : "border-border bg-background text-foreground hover:border-foreground/30 hover:bg-muted/45",
                 )}
                 aria-pressed={active}
@@ -609,7 +625,7 @@ export function PreRecordPanel({
                   className={cn(
                     "mb-3 flex h-9 w-9 items-center justify-center rounded-full",
                     active
-                      ? "bg-primary-foreground/15 text-primary-foreground"
+                      ? "bg-primary/[0.18] text-foreground"
                       : "bg-muted text-muted-foreground",
                   )}
                 >

package/corpus/templates/clips/app/hooks/use-desktop-promo.ts

@@ -1,5 +1,7 @@
 import { useCallback, useEffect, useState } from "react";
 
+import { useIsMobile } from "@/hooks/use-mobile";
+
 const DISMISSED_KEY = "clips.desktop-promo.dismissed";
 
 function detectDesktopApp(): boolean {
@@ -17,6 +19,7 @@ function detectDesktopApp(): boolean {
 }
 
 export function useDesktopPromo() {
+  const isMobile = useIsMobile();
   const [isDesktopApp, setIsDesktopApp] = useState(false);
   const [dismissed, setDismissed] = useState(false);
 
@@ -40,8 +43,9 @@ export function useDesktopPromo() {
 
   return {
     isDesktopApp,
-    shouldShowPromo: !isDesktopApp && !dismissed,
-    shouldShowSidebarLink: !isDesktopApp,
+    isMobile,
+    shouldShowPromo: !isMobile && !isDesktopApp && !dismissed,
+    shouldShowSidebarLink: !isMobile && !isDesktopApp,
     dismiss,
   };
 }

package/corpus/templates/clips/changelog/2026-06-27-clips-no-longer-shows-desktop-app-prompts-on-mobile-screens.md

@@ -0,0 +1,5 @@
+---
+type: fixed
+date: 2026-06-27
+---
+Clips no longer shows desktop app prompts on mobile screens.

package/corpus/templates/clips/changelog/2026-06-27-desktop-storage-setup-flow.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-06-27
+---
+
+Desktop recording now guides you to connect storage with a friendly setup flow instead of a red error.

package/corpus/templates/clips/changelog/2026-06-27-recorder-setup-mobile-capture-options.md

@@ -0,0 +1,5 @@
+---
+type: improved
+date: 2026-06-27
+---
+Recorder setup keeps screen-capture choices desktop-only on mobile and tones down the selected mode highlight.

package/corpus/templates/clips/desktop/src/app.tsx

@@ -1687,9 +1687,7 @@ export function App() {
   const openVideoStorageSetup = useCallback(
     (targetServerUrl?: string) => {
       const base = (targetServerUrl?.trim() || serverUrl).replace(/\/+$/, "");
-      setRecError(
-        "Connect storage before recording from desktop: Builder.io (free tier storage + AI) or S3-compatible storage. Opening storage setup...",
-      );
+      setRecError(STORAGE_SETUP_HELP_TEXT);
       void openExternal(`${base}/record`).catch((err) => {
         setRecError(
           err instanceof Error
@@ -1924,6 +1922,11 @@ export function App() {
       setRecError(MACOS_CAPTURE_PERMISSION_MESSAGE);
       return;
     }
+    if (isStorageSetupFailureMessage(message)) {
+      setRecError(STORAGE_SETUP_HELP_TEXT);
+      openVideoStorageSetup();
+      return;
+    }
     setRecError(message);
   }
 
@@ -2306,6 +2309,8 @@ export function App() {
             panes={["speech", "microphone"]}
             onRetry={handleStartRecording}
           />
+        ) : isStorageSetupFailureMessage(recError) ? (
+          <StorageConnectionBanner onConnect={() => openVideoStorageSetup()} />
         ) : (
           <div className="error-banner">{recError}</div>
         )
@@ -2450,6 +2455,30 @@ function PermissionRecoveryBanner({
   );
 }
 
+function StorageConnectionBanner({ onConnect }: { onConnect: () => void }) {
+  return (
+    <div className="storage-flow-banner">
+      <div className="storage-flow-icon" aria-hidden>
+        <IconUpload size={17} stroke={1.8} />
+      </div>
+      <div className="storage-flow-copy">
+        <div className="storage-flow-title">
+          Connect storage to keep recording
+        </div>
+        <div className="storage-flow-sub">{STORAGE_SETUP_HELP_TEXT}</div>
+      </div>
+      <button
+        type="button"
+        className="storage-flow-connect"
+        onClick={onConnect}
+      >
+        <IconExternalLink size={14} stroke={2} />
+        Connect
+      </button>
+    </div>
+  );
+}
+
 function PendingUploadBanner({
   uploads,
   retryingUploadId,

package/corpus/templates/clips/desktop/src/styles.css

@@ -1680,6 +1680,73 @@ body[data-clips-route="recording-pill"] #root {
   background: var(--surface-hover);
 }
 
+.storage-flow-banner {
+  display: grid;
+  grid-template-columns: auto minmax(0, 1fr);
+  align-items: start;
+  gap: 10px;
+  padding: 10px;
+  border: 1px solid #bfdbfe;
+  border-radius: var(--radius);
+  background: #eff6ff;
+  color: #1e3a8a;
+}
+
+.storage-flow-icon {
+  width: 28px;
+  height: 28px;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  border-radius: 8px;
+  background: rgba(59, 130, 246, 0.12);
+  color: #1d4ed8;
+  flex-shrink: 0;
+}
+
+.storage-flow-copy {
+  min-width: 0;
+}
+
+.storage-flow-title {
+  font-size: 12px;
+  font-weight: 700;
+  line-height: 1.25;
+}
+
+.storage-flow-sub {
+  margin-top: 3px;
+  color: #3b5f9a;
+  font-size: 11px;
+  line-height: 1.35;
+}
+
+.storage-flow-connect {
+  grid-column: 2;
+  justify-self: start;
+  height: 28px;
+  border: 1px solid #bfdbfe;
+  border-radius: var(--radius-sm);
+  background: white;
+  color: #1d4ed8;
+  cursor: pointer;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 5px;
+  padding: 0 9px;
+  font-size: 11px;
+  font-weight: 700;
+  transition:
+    background 120ms,
+    border-color 120ms;
+}
+
+.storage-flow-connect:hover {
+  background: #dbeafe;
+  border-color: #93c5fd;
+}
+
 .pending-upload-banner {
   display: grid;
   grid-template-columns: auto minmax(0, 1fr) auto;

package/corpus/templates/design/app/components/layout/Layout.tsx

@@ -120,7 +120,7 @@ export function Layout({ children }: LayoutProps) {
             )}
             <div
               className={cn(
-                "agent-layout-left-drawer fixed inset-y-0 start-0 z-50 md:static md:z-auto",
+                "agent-layout-left-drawer fixed inset-y-0 start-0 z-50 transition-transform duration-200 ease-out md:static md:z-auto md:transition-none",
                 mobileSidebarOpen
                   ? "translate-x-0"
                   : "-translate-x-full rtl:translate-x-full md:translate-x-0 md:rtl:translate-x-0",

package/corpus/templates/design/changelog/2026-06-27-mobile-navigation-chrome-and-motion.md

@@ -0,0 +1,5 @@
+---
+type: improved
+date: 2026-06-27
+---
+Improved mobile navigation chrome and sidebar drawer motion.

package/corpus/templates/slides/app/components/layout/Layout.tsx

@@ -87,7 +87,7 @@ export function Layout({ children }: LayoutProps) {
           )}
           <div
             className={cn(
-              "agent-layout-left-drawer fixed inset-y-0 start-0 z-50 md:static md:z-auto",
+              "agent-layout-left-drawer fixed inset-y-0 start-0 z-50 transition-transform duration-200 ease-out md:static md:z-auto md:transition-none",
               sidebarOpen
                 ? "translate-x-0"
                 : "-translate-x-full rtl:translate-x-full md:translate-x-0 md:rtl:translate-x-0",

package/corpus/templates/slides/changelog/2026-06-27-mobile-navigation-chrome-and-motion.md

@@ -0,0 +1,5 @@
+---
+type: improved
+date: 2026-06-27
+---
+Improved mobile navigation chrome and sidebar drawer motion.

package/dist/collab/awareness.d.ts

@@ -49,11 +49,11 @@ export declare const postAwareness: import("h3").EventHandlerWithFetch<import("h
     error: string;
     states?: undefined;
 } | {
+    error?: undefined;
     states: {
         clientId: number;
         state: string;
     }[];
-    error?: undefined;
 }>>;
 /**
  * GET /_agent-native/collab/:docId/users
@@ -64,10 +64,10 @@ export declare const getActiveUsers: import("h3").EventHandlerWithFetch<import("
     error: string;
     users?: undefined;
 } | {
+    error?: undefined;
     users: {
         clientId: number;
         lastSeen: number;
     }[];
-    error?: undefined;
 }>>;
 //# sourceMappingURL=awareness.d.ts.map

package/dist/collab/awareness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"awareness.d.ts","sourceRoot":"","sources":["../../src/collab/awareness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAS3C,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAOD,eAAO,MAAM,sBAAsB,EAAG,kBAA2B,CAAC;AAElE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,MAAM,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAKD,wBAAgB,mBAAmB,IAAI,YAAY,CAElD;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EAClD,KAAK,CAAC,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,GACb,IAAI,CAUN;AAKD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAO1E;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,IAAI,CAOnE;AAUD;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa;;;;;kBAuCa,MAAM;eAAS,MAAM;;;GAa1D,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;kBAWM,MAAM;kBAAY,MAAM;;;GAMvD,CAAC"}
+{"version":3,"file":"awareness.d.ts","sourceRoot":"","sources":["../../src/collab/awareness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAS3C,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAOD,eAAO,MAAM,sBAAsB,EAAG,kBAA2B,CAAC;AAElE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,MAAM,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAKD,wBAAgB,mBAAmB,IAAI,YAAY,CAElD;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EAClD,KAAK,CAAC,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,GACb,IAAI,CAUN;AAKD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAO1E;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,IAAI,CAOnE;AAUD;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa;;;;;;kBAuCa,MAAM;eAAS,MAAM;;GAa1D,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;kBAWM,MAAM;kBAAY,MAAM;;GAMvD,CAAC"}

package/dist/observability/routes.d.ts

@@ -41,22 +41,22 @@ export declare function createObservabilityHandler(): import("h3").EventHandlerW
     thumbsUpRate: number;
     avgEvalScore: number;
 } | {
+    ok?: undefined;
     summary: import("./types.js").TraceSummary;
     spans: import("./types.js").TraceSpan[];
-    ok?: undefined;
     error?: undefined;
     id?: undefined;
 } | {
+    ok?: undefined;
     summary?: undefined;
     spans?: undefined;
     id: string;
-    ok?: undefined;
     error?: undefined;
 } | {
+    ok?: undefined;
     summary?: undefined;
     spans?: undefined;
     error: any;
-    ok?: undefined;
     id?: undefined;
 } | {
     summary?: undefined;

package/dist/progress/routes.d.ts

@@ -15,7 +15,7 @@ export declare function createProgressHandler(): import("h3").EventHandlerWithFe
     error: string;
     ok?: undefined;
 } | {
-    ok: boolean;
     error?: undefined;
+    ok: boolean;
 }>>;
 //# sourceMappingURL=routes.d.ts.map

package/dist/resources/handlers.d.ts

@@ -52,8 +52,8 @@ export declare function handleDeleteResource(event: any): Promise<{
     error: string;
     ok?: undefined;
 } | {
-    ok: boolean;
     error?: undefined;
+    ok: boolean;
 }>;
 /** POST /_agent-native/resources/upload — upload a file as a resource */
 export declare function handleUploadResource(event: any): Promise<import("./store.js").Resource | {
@@ -73,9 +73,9 @@ export declare function handleUploadResource(event: any): Promise<import("./stor
     runId: string | null;
     expiresAt: number | null;
     metadata: string | null;
+    error?: undefined;
     url: string;
     provider: string;
-    error?: undefined;
 }>;
 export {};
 //# sourceMappingURL=handlers.d.ts.map

package/dist/server/agent-engine-api-key-route.d.ts

@@ -23,10 +23,10 @@ export declare function resolveAgentEngineApiKeyWriteTarget(event: H3Event, scop
     error: string;
 }>;
 export declare function createAgentEngineApiKeyHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
+    ok?: undefined;
     error: any;
     key?: undefined;
     scope?: undefined;
-    ok?: undefined;
 } | {
     ok: boolean;
     key: string;

package/dist/server/transcribe-voice.d.ts

@@ -20,7 +20,7 @@ export declare function createTranscribeVoiceHandler(): import("h3").EventHandle
     error: string;
     text?: undefined;
 } | {
-    text: string;
     error?: undefined;
+    text: string;
 }>>;
 //# sourceMappingURL=transcribe-voice.d.ts.map

package/docs/content/deployment.md

@@ -66,6 +66,139 @@ background processors. Local `--build-only` artifact checks still run without it
 
 Per-app independent deploy is still supported — just `cd apps/<name> && npx @agent-native/core@latest build` like a standalone scaffold.
 
+### Self-hosted workspace with Docker Compose {#workspace-docker-compose}
+
+The Dockerfile above is for one standalone app. A workspace is not one Nitro
+server process today: each app still builds to its own `.output/` directory and
+runs its own Node/Nitro server. For a VPS, run one container per workspace app,
+point every app at the same Postgres database and shared production secrets, and
+put a reverse proxy in front that routes path prefixes (`/mail`, `/calendar`,
+...) to the matching app container.
+
+Build each app with the same base path that the proxy will use at runtime. The
+base path is a build-time input for the client bundle and a runtime input for
+the server:
+
+```bash
+APP_BASE_PATH=/mail VITE_APP_BASE_PATH=/mail npx @agent-native/core@latest build
+node .output/server/index.mjs
+```
+
+A reusable workspace Dockerfile can take the app name and path prefix as build
+arguments:
+
+```dockerfile
+FROM node:24-slim AS build
+WORKDIR /workspace
+RUN corepack enable
+COPY package.json pnpm-lock.yaml pnpm-workspace.yaml ./
+COPY packages ./packages
+COPY apps ./apps
+ARG APP_NAME
+ARG APP_BASE_PATH
+ENV APP_BASE_PATH=$APP_BASE_PATH
+ENV VITE_APP_BASE_PATH=$APP_BASE_PATH
+RUN pnpm install --frozen-lockfile
+RUN pnpm --dir apps/$APP_NAME build
+
+FROM node:24-slim
+WORKDIR /app
+ARG APP_NAME
+ARG APP_BASE_PATH
+ENV NODE_ENV=production
+ENV PORT=3000
+ENV APP_BASE_PATH=$APP_BASE_PATH
+COPY --from=build /workspace/apps/$APP_NAME/.output .output
+EXPOSE 3000
+CMD ["node", ".output/server/index.mjs"]
+```
+
+Then compose Postgres, the app containers, and your proxy. This example uses
+Caddy because it can terminate HTTP locally or sit behind Cloudflare's SSL
+proxy, but the important part is the path-prefix routing:
+
+```yaml
+services:
+  postgres:
+    image: postgres:17
+    restart: unless-stopped
+    environment:
+      POSTGRES_DB: agent_native
+      POSTGRES_USER: agent_native
+      POSTGRES_PASSWORD: change-me
+    volumes:
+      - postgres-data:/var/lib/postgresql/data
+
+  mail:
+    build:
+      context: .
+      dockerfile: Dockerfile.workspace-app
+      args:
+        APP_NAME: mail
+        APP_BASE_PATH: /mail
+    restart: unless-stopped
+    environment:
+      DATABASE_URL: postgres://agent_native:change-me@postgres:5432/agent_native
+      BETTER_AUTH_URL: https://agents.example.com/mail
+      BETTER_AUTH_SECRET: ${BETTER_AUTH_SECRET}
+      A2A_SECRET: ${A2A_SECRET}
+      ANTHROPIC_API_KEY: ${ANTHROPIC_API_KEY}
+    depends_on:
+      - postgres
+
+  calendar:
+    build:
+      context: .
+      dockerfile: Dockerfile.workspace-app
+      args:
+        APP_NAME: calendar
+        APP_BASE_PATH: /calendar
+    restart: unless-stopped
+    environment:
+      DATABASE_URL: postgres://agent_native:change-me@postgres:5432/agent_native
+      BETTER_AUTH_URL: https://agents.example.com/calendar
+      BETTER_AUTH_SECRET: ${BETTER_AUTH_SECRET}
+      A2A_SECRET: ${A2A_SECRET}
+      ANTHROPIC_API_KEY: ${ANTHROPIC_API_KEY}
+    depends_on:
+      - postgres
+
+  proxy:
+    image: caddy:2
+    restart: unless-stopped
+    ports:
+      - "80:80"
+      - "443:443"
+    volumes:
+      - ./Caddyfile:/etc/caddy/Caddyfile:ro
+    depends_on:
+      - mail
+      - calendar
+
+volumes:
+  postgres-data:
+```
+
+```caddyfile
+agents.example.com {
+  reverse_proxy /mail* mail:3000
+  reverse_proxy /calendar* calendar:3000
+}
+```
+
+Notes for this shape:
+
+- Keep `DATABASE_URL`, `BETTER_AUTH_SECRET`, `A2A_SECRET`, and other production
+  secrets identical across app containers when you want shared auth, shared
+  credentials, and cross-app A2A.
+- Set `BETTER_AUTH_URL` to the public URL for that app path. OAuth callback URLs
+  should use the same public URL.
+- Do not rely on the container filesystem for production data; use Postgres (or
+  another persistent SQL backend) for `DATABASE_URL`.
+- If Cloudflare terminates TLS in front of the VPS, configure Cloudflare to send
+  normal `X-Forwarded-Proto` / `X-Forwarded-Host` headers and route the public
+  host to the proxy container.
+
 ## How It Works {#how-it-works}
 
 When you run `npx @agent-native/core@latest build`, Nitro builds both the client SPA and the server API into `.output/`:

package/docs/content/multi-app-workspace.md

@@ -289,6 +289,8 @@ These settings only affect read-only page navigation. Framework tools, agent cha
 
 Prefer each app on its own domain (`mail.company.com`, `calendar.company.com`)? Every app in the workspace is still an independent deployable — `cd apps/mail && npx @agent-native/core@latest build` behaves exactly like a standalone scaffold. Cross-app A2A then goes through the standard JWT-signed path with a shared `A2A_SECRET`. Cross-domain SSO between separately-deployed apps is handled by identity federation with Dispatch as the hub — see [Cross-App SSO](/docs/cross-app-sso); the unified single-origin deploy avoids needing it.
 
+For a self-hosted VPS or Docker Compose setup on one origin, build and run one container per app with its own path prefix (`APP_BASE_PATH=/mail`, `APP_BASE_PATH=/calendar`, ...), then route those prefixes through a reverse proxy. See [Deployment — Self-hosted workspace with Docker Compose](/docs/deployment#workspace-docker-compose) for the Dockerfile and compose example.
+
 ### Shared database, shared credentials
 
 Whatever you pick, point every app at the same `DATABASE_URL` for cross-app state out of the box: one set of user accounts, one set of organizations, one set of shared settings. If each app has its own database, the workspace pattern still works — you just lose that shared-state story.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.79.19",
+  "version": "0.79.21",
   "description": "Framework for agent-native application development — where AI agents and UI share SQL state, actions, and context",
   "homepage": "https://github.com/BuilderIO/agent-native#readme",
   "bugs": {
@@ -196,6 +196,7 @@
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@mozilla/readability": "0.6.0",
     "@neondatabase/serverless": "^1.1.0",
+    "@opentelemetry/sdk-trace-base": "^2.8.0",
     "@radix-ui/react-dialog": "1.1.15",
     "@radix-ui/react-dropdown-menu": "^2.1.16",
     "@radix-ui/react-hover-card": "^1.1.15",