@agent-native/core 0.95.1 → 0.97.0

package/docs/content/sandbox-adapters.mdx

@@ -106,6 +106,10 @@ The seam lives in core at `packages/core/src/coding-tools/sandbox/` — `adapter
       path: "index.ts",
       note: "selection: getSandboxAdapter() / registerSandboxAdapter()",
     },
+    {
+      path: "background.ts",
+      note: "durable queue marker and background execution lifecycle",
+    },
     {
       path: "local-child-process-adapter.ts",
       note: "the default backend — locked-down Node child process",
@@ -189,12 +193,17 @@ registerSandboxAdapter(adapter)  →  AGENT_NATIVE_SANDBOX  →  local default
 
 #### `AGENT_NATIVE_SANDBOX` env var {#env}
 
-Selects a built-in adapter by id. Currently only `local` (the default) is wired; unknown values fall back to local rather than failing the run.
+Selects a built-in adapter by id. Both `local` (the default) and `background` are wired; unknown values fall back to local rather than failing the run.
 
 ```bash
-AGENT_NATIVE_SANDBOX=local   # the default — explicit
+AGENT_NATIVE_SANDBOX=local        # the default — explicit
+AGENT_NATIVE_SANDBOX=background   # enqueue every run-code call durably
 ```
 
+`background` stores the raw code in `sandbox_executions` and returns an `executionId` with `status: "queued"` immediately. A signed self-dispatch starts a fresh serverless invocation; long-lived Node starts detached in-process work; status polling and the periodic sweep redrive lost dispatches or expired leases. Poll the execution later for its persisted result.
+
+`BackgroundQueueAdapter` is a durable queue marker, not the executor. Queued work uses a registered non-queued execution adapter when one is available; otherwise it falls back to the local child process. Selecting `background` alone does not provide remote or container isolation, and it does not make an edge runtime compatible with `node:child_process`.
+
 #### `registerSandboxAdapter()` {#register}
 
 A host process overrides the backend for all subsequent `run-code` invocations through the seam's `index.ts` — for example, to run every call in a remote container:
@@ -219,13 +228,15 @@ registerSandboxAdapter(new RemoteSandboxAdapter());
 
 ### The seam for a durable runner {#durable}
 
-This interface is deliberately the seam for a future remote/durable sandbox. A remote or durable adapter (Docker, a Vercel-Sandbox-style runner, or a queued background worker) would:
+The built-in `background` adapter already provides durable queuing and a fresh execution budget, while actual execution still uses a non-queued adapter or the local child-process fallback. A separately registered remote or isolated adapter (Docker or a Vercel-Sandbox-style runner) can provide a different execution boundary and can also execute per-call background work.
+
+Such an adapter would:
 
 1. Implement `SandboxAdapter.run` against an out-of-process runtime.
 2. Tunnel the loopback bridge (or proxy bridge calls back to the parent).
-3. Let large data jobs run to completion independently of the request lifecycle — exceeding the hosted ~40s code-exec ceiling that bounds the local child-process adapter.
+3. Supply remote or container isolation independently of the shipped durable queue lifecycle.
 
-Register it under a new `AGENT_NATIVE_SANDBOX` value (e.g. `remote`) and/or via `registerSandboxAdapter()`. The agent loop and `run-code.ts` never change.
+Register it programmatically via `registerSandboxAdapter()`. The agent loop and `run-code.ts` do not need to change.
 
 <Callout id="doc-block-adap1tip" tone="info">
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.95.1",
+  "version": "0.97.0",
   "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": {
@@ -101,6 +101,10 @@
     "./shared": "./dist/shared/index.js",
     "./voice": "./dist/voice/index.js",
     "./scripts": "./dist/scripts/index.js",
+    "./guards": {
+      "types": "./dist/guards/index.d.ts",
+      "default": "./dist/guards/index.js"
+    },
     "./application-state": "./dist/application-state/index.js",
     "./settings": "./dist/settings/index.js",
     "./localization": "./dist/localization/index.js",
@@ -207,6 +211,10 @@
       "default": "./dist/local-artifacts/index.js"
     },
     "./workspace-files": "./dist/workspace-files/index.js",
+    "./package-lifecycle": {
+      "types": "./dist/package-lifecycle/index.d.ts",
+      "default": "./dist/package-lifecycle/index.js"
+    },
     "./code-agents": "./dist/code-agents/index.js",
     "./code-agents/transcript-normalizer": "./dist/code-agents/transcript-normalizer.js",
     "./workspace-connections": "./dist/workspace-connections/index.js",
@@ -219,6 +227,8 @@
     "./terminal/server": "./dist/terminal/index.js",
     "./tailwind": "./dist/tailwind.preset.js",
     "./styles/agent-native.css": "./dist/styles/agent-native.css",
+    "./styles/agent-conversation.css": "./dist/styles/agent-conversation.css",
+    "./styles/chat-history-list.css": "./dist/styles/chat-history-list.css",
     "./agent/engine": "./dist/agent/engine/index.js",
     "./agent/harness": "./dist/agent/harness/index.js",
     "./eval": "./dist/eval/index.js",
@@ -319,7 +329,7 @@
     "y-protocols": "^1.0.7",
     "yjs": "^13.6.31",
     "zod": "^4.3.6",
-    "@agent-native/toolkit": "^0.4.5"
+    "@agent-native/toolkit": "^0.4.6"
   },
   "devDependencies": {
     "@ai-sdk/anthropic": "^3.0.71",
@@ -363,7 +373,6 @@
     "react-dom": "^19.2.7",
     "react-router": "^8.1.0",
     "tailwindcss": "^4.2.4",
-    "typescript": "npm:@typescript/typescript6@^6.0.2",
     "typescript-7": "npm:typescript@^7.0.2",
     "vite": "8.1.0",
     "vitest": "^4.1.5",

package/src/templates/default/package.json

@@ -7,6 +7,7 @@
     "build": "agent-native build",
     "start": "agent-native start",
     "typecheck": "agent-native typecheck",
+    "doctor": "agent-native doctor",
     "action": "agent-native action",
     "script": "agent-native script",
     "skills:update": "agent-native skills update scaffold --project",
@@ -43,8 +44,7 @@
     "tailwind-merge": "^3.5.0",
     "tailwindcss": "^4.1.18",
     "tsx": "^4.20.3",
-    "typescript": "catalog:",
     "typescript-7": "catalog:",
-    "vite": "^8.0.0"
+    "vite": "8.1.0"
   }
 }

package/src/templates/headless/package.json

@@ -19,7 +19,6 @@
     "@types/node": "^24.2.1",
     "oxfmt": "catalog:",
     "tsx": "^4.20.3",
-    "typescript": "catalog:",
     "typescript-7": "catalog:"
   }
 }

package/src/templates/workspace-core/.agents/skills/audit-log/SKILL.md

@@ -77,6 +77,9 @@ SQL to the caller — they never leak another tenant's rows:
   (`agent` | `human` | `system`), `status`, `threadId`/`turnId`, `action`,
   `sinceMs`, `limit`.
 - `get-audit-event` — one event by id, with its redacted input payload.
+- `export-audit-events` — bulk CSV/NDJSON export (same filters minus `limit`,
+  plus `format` and `maxRows`) for offline/compliance pulls; itself audited
+  via `onRead`.
 
 Call them from the UI with `useActionQuery` to build an activity feed or a
 "who changed this" line — never hand-write a fetch to the audit table.

package/src/templates/workspace-core/.agents/skills/automations/SKILL.md

@@ -61,7 +61,7 @@ Use the web-request tool with ${keys.SLACK_WEBHOOK}.
 | `triggerType` | `"schedule" \| "event"`        | How the automation fires                               |
 | `event`       | `string?`                      | Event name to subscribe to (event triggers)            |
 | `condition`   | `string?`                      | Natural-language condition evaluated before dispatch   |
-| `mode`        | `"agentic" \| "deterministic"` | Full agent loop vs. fixed action set                   |
+| `mode`        | `"agentic"`                    | Full agent loop (only supported mode; `"deterministic"` was removed — never implemented, rejected at define time) |
 | `model`       | `string?`                      | Override the model for this trigger's agent loop       |
 | `domain`      | `string?`                      | Grouping tag (mail, calendar, clips, etc.)             |
 | `createdBy`   | `string?`                      | Owner email                                            |

package/src/templates/workspace-core/.agents/skills/observability/SKILL.md

@@ -126,6 +126,26 @@ The agent loop reads active experiments via `resolveActiveExperimentConfig()` an
 
 Compute results with `POST /_agent-native/observability/experiments/:id/results`.
 
+#### First-party hosted default-model rollout
+
+First-party apps on `agent-native.com` automatically run the July 2026
+default-model experiment for authenticated users on the Builder engine:
+
+- 80% `claude-sonnet-5`
+- 20% `gpt-5-6-luna`
+- Assignment is sticky by normalized user email and shared across templates.
+- The rollout applies only when the user, app, and deployment have not selected
+  a model. Explicit model choices and BYO provider engines always win.
+- Set `AGENT_NATIVE_HOSTED_MODEL_EXPERIMENT=off` for an emergency rollback, or
+  `true` to exercise the rollout on a non-first-party preview.
+- `$ai_generation` tracking includes `experiment_id`,
+  `experiment_variant`, and `model_selection_source` for central analysis.
+
+In production, experiment management routes require the caller's email in the
+comma-separated `AGENT_NATIVE_EXPERIMENT_ADMIN_EMAILS` allowlist. This gate is
+separate from normal app/org admin roles because an experiment affects every
+user in that deployment.
+
 ### 5. Dashboard
 
 `ObservabilityDashboard` is a React component with 5 tabs:

package/src/templates/workspace-core/.agents/skills/voice-transcription/SKILL.md

@@ -41,9 +41,13 @@ shared agent sidebar.
 ## Realtime speech mode
 
 Realtime speech mode is a full-duplex OpenAI Realtime WebRTC session, separate
-from the dictation providers below. It requires the authenticated user's
-`OPENAI_API_KEY`, uses the server-owned `gpt-realtime-2.1` session
-configuration, and keeps the key out of browser code.
+from the dictation providers below. It prefers the authenticated user's
+complete Builder connection and the Builder-managed metered gateway. A scoped
+`OPENAI_API_KEY` is the fallback when Builder is not connected. The server owns
+the `gpt-realtime-2.1` session configuration and keeps credentials out of
+browser code. If neither provider is configured, show **Connect Builder** as
+the primary microphone-popover action and OpenAI key setup as the secondary
+action before requesting microphone permission.
 
 - Starting voice mode collapses the chat into a persistent bottom-end speech
   orb. The orb stays visible above the chat even when the chat opens
@@ -169,7 +173,7 @@ client.
 
 Templates can:
 - **Disable the mic**: pass `voiceEnabled={false}` to `TiptapComposer`.
-- **Replace the button**: wrap `TiptapComposer` and render your own `extraActionButton` (the framework mic sits between `extraActionButton` and the send button).
+- **Replace the button**: wrap `TiptapComposer` and render your own `extraActionButton`; the framework mic stays immediately before the primary send/stop control. Use `stopButton` for an active-run control so the disabled send button becomes stop when the draft is empty and returns when the user types.
 - **Pre-register provider keys as `required: true`**: call `registerRequiredSecret(...)` from your own server plugin when a template needs a specific BYOK provider in onboarding.
 
 ## Don'ts

package/src/templates/workspace-core/package.json

@@ -32,7 +32,6 @@
     "prepare": "tsc"
   },
   "devDependencies": {
-    "typescript": "catalog:",
     "typescript-7": "catalog:"
   }
 }

package/src/templates/workspace-root/package.json

@@ -20,7 +20,6 @@
     "@types/node": "^24.2.1",
     "oxfmt": "catalog:",
     "tsx": "catalog:",
-    "typescript": "catalog:",
     "typescript-7": "catalog:"
   },
   "packageManager": "pnpm@10.14.0",

package/corpus/templates/slides/app/components/ui/toast.tsx

@@ -1 +0,0 @@
-export * from "@agent-native/toolkit/ui/toast";

package/corpus/templates/slides/app/components/ui/toaster.tsx

@@ -1 +0,0 @@
-export * from "@agent-native/toolkit/ui/toaster";

package/corpus/templates/slides/app/hooks/use-toast.ts

@@ -1 +0,0 @@
-export * from "@agent-native/toolkit/hooks/use-toast";