eve 0.64.0 → 0.65.0

package/docs/guides/evaluate.md

@@ -14,7 +14,8 @@ patch releases.
 
 ## Choose from Gateway models
 
-By default, `auto` evaluates with `typesafe-ai/jev`. Like other AI SDK
+By default, `auto` evaluates with `typesafe-ai/jev`, TypeSafe AI's
+[Jev evaluation model](https://vercel.com/i/what-is-jev). Like other AI SDK
 model strings, it uses Vercel AI Gateway unless the application has configured a
 different global default provider.
 
@@ -25,8 +26,8 @@ import { auto } from "eve/models";
 export default defineAgent({
   model: auto({
     options: {
-      "openai/gpt-5.6-sol": "Difficult reasoning and engineering tasks",
-      "openai/gpt-5.6-luna": "Routine tasks where fast completion matters",
+      "openai/gpt-6-sol": "Difficult reasoning and engineering tasks",
+      "openai/gpt-6-luna": "Routine tasks where fast completion matters",
     },
   }),
 });
@@ -38,7 +39,7 @@ Gateway evaluator uses the same connection selected through `/login` as Gateway
 language models. A configured AI SDK default provider still owns string model
 resolution during development. The TUI footer displays `dynamic model` when the
 agent uses `auto`, then adds the resolved model for the current turn, such as
-`dynamic model · openai/gpt-5.6-luna`.
+`dynamic model · openai/gpt-6-luna`.
 
 ## Use a provider directly
 
@@ -58,8 +59,8 @@ export default defineAgent({
   model: auto({
     model: typeSafeAi.evaluationModel("jev-latest"),
     options: {
-      "openai/gpt-5.6-sol": "Difficult reasoning and engineering tasks",
-      "openai/gpt-5.6-luna": "Routine tasks where fast completion matters",
+      "openai/gpt-6-sol": "Difficult reasoning and engineering tasks",
+      "openai/gpt-6-luna": "Routine tasks where fast completion matters",
     },
   }),
 });
@@ -83,7 +84,7 @@ export default defineAgent({
   reasoning: "medium",
   model: auto({
     options: {
-      "openai/gpt-5.6-sol": "Hard problems",
+      "openai/gpt-6-sol": "Hard problems",
       my_secret_model: {
         model: anthropic("sonnet-5"),
         description: "Routine work that can use the direct Anthropic provider",
@@ -141,7 +142,7 @@ export default defineTool({
 
 The choice above is typed as `"billing" | "support"`. Each question appears under
 its authored key in `result.answers`. Results also include token usage, warnings,
-provider metadata, and response metadata. To use that choice to delegate while keeping specialist subagents out of the parent model's tools, see [Route to a hidden subagent with JEV](/docs/tools/workflows#route-to-a-hidden-subagent-with-jev).
+provider metadata, and response metadata. To use that choice to delegate while keeping specialist subagents out of the parent model's tools, see [Route to a hidden subagent with Jev](/docs/tools/workflows#route-to-a-hidden-subagent-with-jev).
 
 `evaluate` accepts AI SDK evaluation options, including `maxRetries`, `headers`,
 and `providerOptions`. Pass an `abortSignal` to cancel the request. Input and
@@ -178,7 +179,9 @@ export default defineTool({
 The evaluation model reviews the tool name and input for dangerous effects. A
 caution, failed review, or incomplete input requires human approval. See
 [Human-in-the-loop approvals](/docs/human-in-the-loop#approvals) for classifier
-options and data handling.
+options and data handling, and the
+[Auto-approve tool calls with Jev](https://vercel.com/kb/guide/auto-approve-tool-calls-eve-jev)
+guide for an end-to-end walkthrough.
 
 ## Runtime behavior
 

package/docs/guides/frontend/overview.mdx

@@ -218,7 +218,7 @@ received attachment as a `file` part on the user message. The part includes `med
 
 ## Human-in-the-loop prompts
 
-Tools opt into approval with `approval`, and the model can also ask a question with `ask_question` — see [Human-in-the-loop](/docs/human-in-the-loop) for the server-side model. Either way the stream emits an `input.requested` event, and the pending request rides on a `dynamic-tool` part at `part.toolMetadata?.eve?.inputRequest`. Scan every message because an unrelated turn can add newer messages while an approval stays open, then answer through the same session with `respond()`:
+Tools opt into approval with `approval`, and workflow tools such as the opt-in `ask_question` tool ask the user a question with `ctx.ask()` — see [Human-in-the-loop](/docs/human-in-the-loop) for the server-side model. Either way the stream emits an `input.requested` event, and the pending request rides on a `dynamic-tool` part at `part.toolMetadata?.eve?.inputRequest`. Scan every message because an unrelated turn can add newer messages while an approval stays open, then answer through the same session with `respond()`:
 
 ```tsx
 const pendingRequests = agent.data.messages

package/docs/guides/instrumentation/instrumentation.mdx

@@ -159,6 +159,6 @@ not depend on execution order. Use `flush` to drain buffered records and
 ## What to read next
 
 - [Migrate instrumentation](/docs/observability/instrumentation-migration): replace `agent/instrumentation.ts`.
-- [OpenTelemetry](/docs/observability/otel): configure OTel destinations and managed exports.
+- [OpenTelemetry](/docs/observability/otel): configure OTel destinations and third-party exports.
 - [Local development](../guides/dev-tui): inspect local traces in the TUI
 - [Hooks](../guides/hooks): react to runtime events outside the instrumentation lifecycle

package/docs/guides/instrumentation/migration.md

@@ -89,9 +89,4 @@ see
 Run `eve build`. A remaining `agent/instrumentation.ts` fails the build with a
 message directing you to the instrumentation directory.
 
-Before verifying a Vercel deployment, configure trace sampling. A deployed eve
-project needs at least one sampling rule with a rate above 0%; we recommend
-setting the rate to 100%. See
-[Enable tracing on Vercel](/docs/observability/otel#enable-tracing-on-vercel).
-
-Then run the agent and verify each destination independently.
+Run the agent and verify each destination independently.

package/docs/guides/instrumentation/otel.mdx

@@ -1,13 +1,11 @@
 ---
 title: "OpenTelemetry"
-description: "Configure OpenTelemetry destinations, content capture, and managed exports."
+description: "Configure OpenTelemetry destinations, content capture, and third-party exports."
 url: "/observability/otel"
 ---
 
-eve configures its built-in OpenTelemetry destinations automatically.
-`eve dev` records local traces, and preview and production deployments export
-to Vercel Agent Runs by default. You do not need `otel()` or
-`otelIntegration()` to use these defaults.
+`eve dev` records local traces automatically. You do not need `otel()` or
+`localTraces()` to use this default.
 
 ## Configure OpenTelemetry
 
@@ -118,11 +116,7 @@ lineage and trace-content policy. See [Remote agents](../guides/remote-agents#pr
 Use `gen_ai.conversation.id` to find the traces for one conversation in your
 destination's span-search surface.
 
-## Manage built-in destinations
-
-Instrumentation has two environment-specific defaults.
-
-### Local traces
+## Local traces
 
 `eve dev` records local traces by default. Omitting
 `agent/instrumentation/local.ts` preserves that default. Export
@@ -134,42 +128,16 @@ import { disableInstrumentation } from "eve/instrumentation";
 export default disableInstrumentation();
 ```
 
-### Vercel Agent Runs
-
-Preview and production deployments export to Vercel Agent Runs by default.
-Omitting `agent/instrumentation/agent-runs.ts` preserves that default. Export
-`agentRuns(...)` from that file to reconfigure it, or export
-`disableInstrumentation()` to disable it.
-
-## Enable tracing on Vercel
-
-A deployed eve project needs at least one
-[sampling rule with a rate above 0%](https://vercel.com/docs/tracing/always-on-tracing#enable-always-on-tracing)
-before Vercel collects traces. We recommend setting the rate to **100%** for
-eve projects so every matching request is traced.
-
-Select your team and project, then open
-[**Settings → Tracing**](https://vercel.com/d?to=%2F%5Bteam%5D%2F%5Bproject%5D%2Fsettings%2Ftracing&title=Go+to+Tracing+settings):
-
-1. Select **Add Sampling Rule**.
-2. Choose **All Environments**, **Production**, or **Preview**.
-3. Set **Rate** to `100%`.
-4. Select **Save**.
-
-Tracing starts as soon as you save the rule. You can also manage sampling
-rules with [`vercel traces config`](https://vercel.com/docs/cli/traces#manage-trace-sampling-rules).
-The CLI accepts rates from 1 to 100%; add a 0% rule from the dashboard.
-
 ## Filter a destination
 
-`otelIntegration()`, `localTraces()`, and `agentRuns()` accept one
+`otelIntegration()` and `localTraces()` accept one
 `exportPolicy` object or an array applied in order. Each policy filters spans
 and attributes before that destination's processors receive them:
 
-```ts title="agent/instrumentation/agent-runs.ts"
-import { agentRuns } from "eve/instrumentation/otel";
+```ts title="agent/instrumentation/local.ts"
+import { localTraces } from "eve/instrumentation/otel";
 
-export default agentRuns({
+export default localTraces({
   exportPolicy: {
     span: ({ name }) => ({ emit: name !== "internal.cache.refresh" }),
     attribute: ({ key }) => (key === "customer.id" ? { emit: false } : { emit: true }),
@@ -188,17 +156,17 @@ A throwing `span` callback drops the span from this destination. Return
 `{ replace: true, value }` from `attribute` to retain, remove, or change
 one attribute.
 
-### Further narrow a built-in destination
+### Redact content from local traces
 
-Return a redaction decision to further narrow what a built-in destination
+Return a redaction decision to further narrow what the local trace destination
 receives after the process-wide `otel({ tracePolicy })` has admitted a trace.
-For example, keep the spans in Agent Runs while redacting their inputs and
-outputs unless the session is public:
+For example, keep spans in the local trace viewer while redacting their inputs
+and outputs unless the session is public:
 
-```ts title="agent/instrumentation/agent-runs.ts"
-import { agentRuns } from "eve/instrumentation/otel";
+```ts title="agent/instrumentation/local.ts"
+import { localTraces } from "eve/instrumentation/otel";
 
-export default agentRuns({
+export default localTraces({
   exportPolicy: {
     span: ({ audience }) =>
       audience === "public" ? { emit: true } : { redact: true, inputs: true, outputs: true },

package/docs/reference/cli.md

@@ -59,12 +59,12 @@ Existing packages do not need a target-selection prompt: run `eve init` from the
 
 After scaffolding in an interactive human terminal, eve opens the TUI directly. Pass `-n` or `--non-interactive` to return after scaffolding instead. It still installs dependencies and follows the normal Git setup behavior. Noninteractive and coding-agent invocations return without starting an interactive session. Fresh projects use the parent workspace's package manager when there is one; otherwise they use the manager that launched `eve init`.
 
-| Flag                    | Type   | Default                    | Description                                                                                                              |
-| ----------------------- | ------ | -------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
-| `--model <model>`       | string | `openai/gpt-5.6-luna-fast` | Set the root agent's AI Gateway model ID.                                                                                |
-| `--reasoning <effort>`  | enum   | provider default           | Set reasoning to `none`, `minimal`, `low`, `medium`, `high`, or `xhigh`. `provider-default` leaves the field unauthored. |
-| `--channel-web-nextjs`  | flag   | off                        | Add the Web Chat app (Next.js). Not for existing projects — run `eve add channel/web` there instead.                     |
-| `-n, --non-interactive` | flag   | off                        | Scaffold and install dependencies without starting development.                                                          |
+| Flag                    | Type   | Default                  | Description                                                                                                              |
+| ----------------------- | ------ | ------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
+| `--model <model>`       | string | `openai/gpt-6-luna-fast` | Set the root agent's AI Gateway model ID.                                                                                |
+| `--reasoning <effort>`  | enum   | provider default         | Set reasoning to `none`, `minimal`, `low`, `medium`, `high`, or `xhigh`. `provider-default` leaves the field unauthored. |
+| `--channel-web-nextjs`  | flag   | off                      | Add the Web Chat app (Next.js). Not for existing projects — run `eve add channel/web` there instead.                     |
+| `-n, --non-interactive` | flag   | off                      | Scaffold and install dependencies without starting development.                                                          |
 
 ## `eve extension`
 
@@ -102,7 +102,7 @@ Change the root agent's AI Gateway model and reasoning effort without opening th
 
 ```bash
 eve set \
-  --model openai/gpt-5.6-sol \
+  --model openai/gpt-6-sol \
   --reasoning high
 ```
 
@@ -223,6 +223,7 @@ Pass a bare URL and the UI connects to that server instead of booting a local on
 | `-u, --url <url>`                   | string | none               | Connect to an existing server URL instead of starting one                                 |
 | `-H, --header <header>`             | string | none               | Request header for a URL target, in `Name: value` form; repeat for multiple headers       |
 | `--no-ui`                           | flag   | UI on              | Start the server without an interactive UI                                                |
+| `--no-default-extensions`           | flag   | extensions on      | Do not mount bundled development extensions                                               |
 | `--name <name>`                     | string | app folder name    | Title shown in the terminal UI                                                            |
 | `--input <text>`                    | string | none               | Pre-fill the prompt input                                                                 |
 | `--tools <mode>`                    | enum   | `auto-collapsed`   | Tool-call rendering: `full` \| `collapsed` \| `auto-collapsed` \| `hidden`                |
@@ -233,6 +234,8 @@ Pass a bare URL and the UI connects to that server instead of booting a local on
 | `--context-size <tokens>`           | number | none               | Model context window size, shown as a usage percentage                                    |
 | `--logs <mode>`                     | enum   | `stderr`           | Server/agent logs to show: `all` \| `stderr` \| `sandbox` \| `none`                       |
 
+Local development mounts bundled development extensions without adding files to your project. The default set includes the self-modification extension and its `self-modification__agent` subagent. Pass `--no-default-extensions` to disable the complete set for that server.
+
 `eve acp` reserves stdin and stdout for newline-delimited JSON-RPC and sends diagnostics to stderr. Without a URL, it supervises an isolated local development server. With a URL, it bridges ACP to that server's existing eve HTTP API and accepts the same URL credentials and request headers as `eve dev <url>`. Pass `--scope <team>` when the active Vercel scope does not own the deployment; `EVE_VERCEL_SCOPE` provides the same value for managed harnesses. See [Agent Client Protocol (ACP)](../protocols/acp) for client configuration and capability limits.
 
 A fresh `eve init` opens the TUI and reuses an available model connection or opens `/login`. No Vercel project, channels, integrations, or review step is required before chat. Use `/model` to change models and settings, and `/add` to install an addition. Other `--input` text stays editable in the prompt. See [Terminal UI](../guides/dev-tui) for credential precedence and login options.

package/docs/reference/typescript-api.md

@@ -12,7 +12,7 @@ Most files look the same: import a helper, default-export the result.
 ```ts title="agent/agent.ts"
 import { defineAgent } from "eve";
 
-export default defineAgent({ model: "anthropic/claude-opus-4.8" });
+export default defineAgent({ model: "anthropic/claude-opus-5.5" });
 ```
 
 ```ts title="agent/tools/get_weather.ts"
@@ -113,56 +113,57 @@ Tool definitions accept `availableInSubagents: false` to restrict the tool to to
 
 ## Imports at a glance
 
-| Import                                                                      | Holds                                                                                                                          |
-| --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
-| `eve`                                                                       | `defineAgent`, `defineRemoteAgent`, `defineDynamic`, agent config types                                                        |
-| `eve/tools`                                                                 | `defineTool`, `defineWorkflowTool`, `defineDurableCallback`, `defineDurableSchema`, `defineDynamic`, `disableTool`, tool types |
-| `eve/tools/{bash,read_file,write_file,todo,web_fetch,load_skill,glob,grep}` | Individual reusable tool definitions                                                                                           |
-| `eve/tools/approval`                                                        | Approval types and `auto`, `always`, `once`, `never`                                                                           |
-| `eve/tools/web_search`                                                      | Provider-managed `webSearch` configuration                                                                                     |
-| `eve/tools/workflow`                                                        | Runtime-generated `workflow` tool factory                                                                                      |
-| `eve/tools/sleep`                                                           | Opt-in durable `sleep` tool                                                                                                    |
-| `eve/connections`                                                           | `defineMcpClientConnection`, `defineOpenAPIConnection`, `defineDynamic`                                                        |
-| `eve/channels`                                                              | `defineChannel`, `disableRoute`, route verbs                                                                                   |
-| `eve/channels/eve`                                                          | `eveChannel`                                                                                                                   |
-| `eve/channels/auth`                                                         | `localDev`, `vercelOidc`, `placeholderAuth`                                                                                    |
-| `eve/channels/{slack,discord,teams,telegram,twilio,github}`                 | platform channel factories                                                                                                     |
-| `eve/hooks`                                                                 | `defineHook`                                                                                                                   |
-| `eve/schedules`                                                             | `defineSchedule`                                                                                                               |
-| `eve/skills`                                                                | `defineSkill`, `defineDynamic`                                                                                                 |
-| `eve/instructions`                                                          | `defineInstructions`, `defineDynamic`                                                                                          |
-| `eve/memory`                                                                | `defineMemory`, `defineMemoryProvider`, provider and lifecycle types                                                           |
-| `eve/memory/scope`                                                          | `byPrincipal` and memory scope helpers                                                                                         |
-| `eve/memory/file`                                                           | `fileMemory`, `inMemory`, and the conditional document backend contract                                                        |
-| `eve/memory/file/vercel`                                                    | `vercelBlob` and Vercel Blob backend options                                                                                   |
-| `eve/context`                                                               | `defineState`, session and state types                                                                                         |
-| `eve/sandbox`                                                               | `defineSandbox`, provider environments, and sandbox session types                                                                                                      |
-| `eve/instrumentation`                                                       | `defineInstrumentation`, `disableInstrumentation`, `isChannel`, lifecycle provider types                                       |
-| `eve/instrumentation/otel`                                                  | `otel`, `otelIntegration`, `localTraces`, `agentRuns`, OpenTelemetry policy types                                              |
-| `eve/local-dev`                                                             | `getLocalDevCapability`, `LocalDevCapability`                                                                                  |
-| [`eve/models`](../guides/evaluate)                                          | Automatic model selection with `auto`                                                                                          |
-| `eve/models/openai`                                                         | `openai`, `chatgpt`, deprecated `experimental_chatgpt`                                                                         |
-| `eve/models/anthropic`                                                      | `anthropic`                                                                                                                    |
-| [`eve/ai`](../guides/evaluate#evaluate-inside-a-tool)                       | Standalone `evaluate`                                                                                                          |
-| `eve/evals`                                                                 | `defineEval`, `defineEvalConfig`, `mockModel`, eval types                                                                      |
-| `eve/evals/expect`                                                          | `includes`, `equals`, `matches`, `similarity`                                                                                  |
-| `eve/evals/reporters`                                                       | `Braintrust`, `JUnit`, `EvalReporter`                                                                                          |
-| `eve/evals/loaders`                                                         | `loadJson`, `loadYaml`                                                                                                         |
-| `eve/react`, `eve/vue`, `eve/svelte`                                        | `useEveAgent`                                                                                                                  |
-| `eve/next`, `eve/nuxt`, `eve/sveltekit`                                     | framework bundler plugins                                                                                                      |
-| [`eve/client`](../guides/client/overview)                                   | `Client`, `ClientSession`, health and agent-info schemas, response errors                                                      |
+| Import                                                                 | Holds                                                                                                                          |
+| ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
+| `eve`                                                                  | `defineAgent`, `defineRemoteAgent`, `defineDynamic`, agent config types                                                        |
+| `eve/tools`                                                            | `defineTool`, `defineWorkflowTool`, `defineDurableCallback`, `defineDurableSchema`, `defineDynamic`, `disableTool`, tool types |
+| `eve/tools/{bash,read_file,write_file,web_fetch,load_skill,glob,grep}` | Individual reusable tool definitions                                                                                           |
+| `eve/tools/approval`                                                   | Approval types and `auto`, `always`, `once`, `never`                                                                           |
+| `eve/tools/ask_question`                                               | Opt-in `askQuestion` tool factory                                                                                              |
+| `eve/tools/web_search`                                                 | Provider-managed `webSearch` configuration                                                                                     |
+| `eve/tools/workflow`                                                   | Runtime-generated `workflow` tool factory                                                                                      |
+| `eve/tools/sleep`                                                      | Opt-in durable `sleep` tool                                                                                                    |
+| `eve/connections`                                                      | `defineMcpClientConnection`, `defineOpenAPIConnection`, `defineDynamic`                                                        |
+| `eve/channels`                                                         | `defineChannel`, `disableRoute`, route verbs                                                                                   |
+| `eve/channels/eve`                                                     | `eveChannel`                                                                                                                   |
+| `eve/channels/auth`                                                    | `localDev`, `vercelOidc`, `placeholderAuth`                                                                                    |
+| `eve/channels/{slack,discord,teams,telegram,twilio,github}`            | platform channel factories                                                                                                     |
+| `eve/hooks`                                                            | `defineHook`                                                                                                                   |
+| `eve/schedules`                                                        | `defineSchedule`                                                                                                               |
+| `eve/skills`                                                           | `defineSkill`, `defineDynamic`                                                                                                 |
+| `eve/instructions`                                                     | `defineInstructions`, `defineDynamic`                                                                                          |
+| `eve/memory`                                                           | `defineMemory`, `defineMemoryProvider`, provider and lifecycle types                                                           |
+| `eve/memory/scope`                                                     | `byPrincipal` and memory scope helpers                                                                                         |
+| `eve/memory/file`                                                      | `fileMemory`, `inMemory`, and the conditional document backend contract                                                        |
+| `eve/memory/file/vercel`                                               | `vercelBlob` and Vercel Blob backend options                                                                                   |
+| `eve/context`                                                          | `defineState`, session and state types                                                                                         |
+| `eve/sandbox`                                                          | `defineSandbox`, provider environments, and sandbox session types                                                              |
+| `eve/instrumentation`                                                  | `defineInstrumentation`, `disableInstrumentation`, `isChannel`, lifecycle provider types                                       |
+| `eve/instrumentation/otel`                                             | `otel`, `otelIntegration`, `localTraces`, OpenTelemetry policy types                                                           |
+| `eve/local-dev`                                                        | `getLocalDevCapability`, `LocalDevCapability`                                                                                  |
+| [`eve/models`](../guides/evaluate)                                     | Automatic model selection with `auto`                                                                                          |
+| `eve/models/openai`                                                    | `openai`, `chatgpt`, deprecated `experimental_chatgpt`                                                                         |
+| `eve/models/anthropic`                                                 | `anthropic`                                                                                                                    |
+| [`eve/ai`](../guides/evaluate#evaluate-inside-a-tool)                  | Standalone `evaluate`                                                                                                          |
+| `eve/evals`                                                            | `defineEval`, `defineEvalConfig`, `mockModel`, eval types                                                                      |
+| `eve/evals/expect`                                                     | `includes`, `equals`, `matches`, `similarity`                                                                                  |
+| `eve/evals/reporters`                                                  | `Braintrust`, `JUnit`, `EvalReporter`                                                                                          |
+| `eve/evals/loaders`                                                    | `loadJson`, `loadYaml`                                                                                                         |
+| `eve/react`, `eve/vue`, `eve/svelte`                                   | `useEveAgent`                                                                                                                  |
+| `eve/next`, `eve/nuxt`, `eve/sveltekit`                                | framework bundler plugins                                                                                                      |
+| [`eve/client`](../guides/client/overview)                              | `Client`, `ClientSession`, health and agent-info schemas, response errors                                                      |
 
 Exported types ship from the same entrypoint as the helper they describe (for example `ToolDefinition` and `ToolContext` from `eve/tools`). The `exports` field in `packages/eve/package.json` lists every public entrypoint.
 
 ## Direct provider models
 
-`openai(model?)` from `eve/models/openai` and `anthropic(model?)` from `eve/models/anthropic` return eve-owned model instances using the vendored providers. They accept only an optional model ID. Defaults are `gpt-5.6-luna-fast` and `claude-sonnet-5`, respectively.
+`openai(model?)` from `eve/models/openai` and `anthropic(model?)` from `eve/models/anthropic` return eve-owned model instances using the vendored providers. They accept only an optional model ID. Defaults are `gpt-6-luna-fast` and `claude-sonnet-5`, respectively.
 
 Use `/login` for local credentials, or set `OPENAI_API_KEY` or `ANTHROPIC_API_KEY`. Local secret-store discovery is disabled in deployments; provision server credentials explicitly. See [Set the model](../agent-config#set-the-model) for an example.
 
 ## ChatGPT subscription models
 
-`chatgpt()` from `eve/models/openai` serves an OpenAI model through your local ChatGPT login and bills the ChatGPT subscription. With no argument, it selects `gpt-5.6-luna-fast`:
+`chatgpt()` from `eve/models/openai` serves an OpenAI model through your local ChatGPT login and bills the ChatGPT subscription. With no argument, it selects `gpt-6-luna-fast`:
 
 ```ts title="agent/agent.ts"
 import { defineAgent } from "eve";

package/docs/sandbox/index.mdx

@@ -80,7 +80,9 @@ export default defineSandbox(() => environment.open());
 
 eve runs `prepare` while creating a reusable provider artifact, not once for each live session sandbox. Vercel captures a snapshot; Docker captures an image; microsandbox captures a VM snapshot; and just-bash captures a filesystem template.
 
-At runtime, eve passes the recorded artifact directly to the provider when it creates a live sandbox. Runtime does not rebuild or repair a missing artifact. A missing image, snapshot, or template fails with rebuild or redeploy guidance.
+During `eve dev`, startup and authored-source rebuilds do not prepare sandbox environments. The first sandbox access prepares all environments in that compiled generation before opening the requested sandbox. This includes environments declared by subagents and extensions, even if they use different providers. Concurrent requests share the preparation work; a failed preparation can be retried on a later access. Optional provider installation and setup can make that first access slow.
+
+`eve build` still prepares environments eagerly. In production, eve passes the recorded artifact directly to the provider when it creates a live sandbox. Production runtime does not rebuild or repair a missing artifact. A missing image, snapshot, or template fails with rebuild or redeploy guidance.
 
 ### Reuse native resources across sessions
 

package/docs/sandbox/just-bash.mdx

@@ -15,4 +15,10 @@ export default defineSandbox(() => environment.open());
 
 just-bash can prepare and persist its virtual filesystem. It cannot use OCI images or Dockerfiles, does not run native processes, and provides no network isolation. The session does not expose `setNetworkPolicy()`.
 
+## Automatic installation
+
+When an environment uses just-bash during `eve dev`, eve installs the package into your application if it is missing, unless you set `autoInstall: false` in the environment options. `DefaultSandbox` selects only one provider, but another environment, such as local self-modification, can use just-bash independently. Other environments require you to install the package yourself.
+
+For pnpm projects, automatic installation adds `@mongodb-js/zstd` and `node-liblzma` to `ignoredOptionalDependencies` in the owning `pnpm-workspace.yaml` when they have no explicit package policy. These optional native codecs are not needed for basic shell and filesystem operations. Commands that require those codecs may be unavailable without them. eve preserves existing package-specific build decisions and does not automatically approve build scripts.
+
 See the [sandbox overview](/docs/sandbox) for managed workspace, skills, parent inheritance, and custom providers.

package/docs/skills.mdx

@@ -91,6 +91,8 @@ The handle exposes the skill's `name` and `file(relativePath)`; file content is
 
 To serve a different skill per principal, tenant, or channel (the caller's own team playbook, say), wrap `defineSkill` in a `defineDynamic` resolver keyed on `ctx.session.auth`. See [Dynamic capabilities](./guides/dynamic-capabilities).
 
+Subagent lifecycle events do not re-run skill resolvers. The parent's resolved dynamic skills remain available when it resumes after delegation.
+
 ## What to read next
 
 - [Connections](./connections): add tools from external MCP and OpenAPI servers

package/docs/subagents/index.mdx

@@ -63,7 +63,7 @@ To prevent the root session from delegating to a fresh copy of itself, set `tool
 import { defineAgent } from "eve";
 
 export default defineAgent({
-  model: "anthropic/claude-opus-4.8",
+  model: "anthropic/claude-opus-5.5",
   tool: false,
 });
 ```
@@ -79,7 +79,7 @@ import { defineAgent } from "eve";
 
 export default defineAgent({
   description: "Investigate ambiguous questions before the parent agent responds.",
-  model: "anthropic/claude-opus-4.8",
+  model: "anthropic/claude-opus-5.5",
 });
 ```
 
@@ -90,7 +90,7 @@ import { defineAgent } from "eve";
 
 export default defineAgent({
   description: "Investigate ambiguous questions for the routing workflow.",
-  model: "anthropic/claude-opus-4.8",
+  model: "anthropic/claude-opus-5.5",
   tool: false,
 });
 ```
@@ -103,6 +103,8 @@ Every declared local or remote subagent runs as a durable background task: the c
 
 A mounted extension can also contribute declared subagents from `extension/subagents/`. The mount namespace prefixes the subagent visible to the consuming agent node: mounting an extension as `crm` exposes its `reviewer` subagent as `crm__reviewer`. The contributed subagent keeps its own isolated tools, connections, skills, hooks, instructions, sandbox, and nested subagents, and its modules can read configuration from the extension handle. See [Extensions](./extensions#add-a-subagent) for the authoring and override behavior.
 
+Local `eve dev` mounts the bundled self-modification extension by default, which exposes the `self-modification__agent` subagent without adding files to your project. An authored extension mounted as `self-modification` takes its place. Pass `--no-default-extensions` to run without bundled development extensions. Production builds do not include development extensions unless you mount them in your agent.
+
 ### Vercel workspace peers
 
 In a Vercel agent workspace, expose one other workspace member as a remote subagent with `defineWorkspaceAgent`. Create an ordinary file under the caller's `agent/subagents/` directory. Its filename gives the model-visible tool name; `name` identifies the peer under `agents/`.
@@ -149,7 +151,7 @@ export default defineDynamic({
       ctx.session.auth.current?.attributes.research === true
         ? defineAgent({
             description: "Investigate ambiguous questions before the parent responds.",
-            model: "anthropic/claude-opus-4.8",
+            model: "anthropic/claude-opus-5.5",
           })
         : null,
   },
@@ -172,7 +174,7 @@ export default defineDynamic({
     "session.started": () =>
       defineAgent({
         description: "Use a native package when handling delegated work.",
-        model: "anthropic/claude-opus-4.8",
+        model: "anthropic/claude-opus-5.5",
       }),
   },
 });

package/docs/tools/human-in-the-loop.md

@@ -39,7 +39,7 @@ export default defineTool({
 
 By default, omitted `approval` behaves like `never()`, so tool calls may execute without human approval. Require human approval or other safeguards for sensitive, irreversible, regulated, financial, healthcare, employment, housing, legal, safety-impacting, user-impacting, or external side-effecting actions.
 
-`auto()` uses an [AI SDK evaluation model](/docs/guides/evaluate) to classify each call as `clear` or `caution`. It defaults to `typesafe-ai/jev`. Like `evaluate`, a model string uses Vercel AI Gateway unless the application configures a global AI SDK default provider:
+`auto()` uses an [AI SDK evaluation model](/docs/guides/evaluate) to classify each call as `clear` or `caution`. It defaults to `typesafe-ai/jev`, TypeSafe AI's [Jev evaluation model](https://vercel.com/i/what-is-jev). Like `evaluate`, a model string uses Vercel AI Gateway unless the application configures a global AI SDK default provider:
 
 ```ts
 approval: auto({ model: "typesafe-ai/jev" });
@@ -150,27 +150,38 @@ export default defineTool({
 
 ## Questions
 
-The built-in `ask_question` tool lets the model pause and ask the user, rather than guessing. It has no `execute` — the model calls it with `{ prompt, options?, allowFreeform? }`:
+The `ask_question` tool lets the model pause and ask the user one question, rather than guessing. The model calls it with `{ question, options? }`:
 
-- `prompt`: the question to put to the user.
-- `options`: an optional list of choices to offer. Channels render these as buttons or a select menu.
-- `allowFreeform`: whether the user may answer with free text instead of picking an option.
+- `question`: the question to put to the user, with the context needed to answer it.
+- `options`: two or three mutually exclusive choices, each with a `label` and a one-sentence `description`. Channels render these as buttons or a select menu. Omit `options` for an open-ended question.
 
-`ask_question` is part of the [default tool set](/docs/concepts/built-in-tools), so it is available without you defining anything. It produces the same `input.requested` pause as an approval, and resumes the same way.
+The user can always type their own answer instead of picking an option, so the model never needs an "Other" option. The tool returns `{ status: "answered", answer }` with the chosen option's label or the user's words, `{ status: "dismissed" }` when the user moved on without answering, or `{ status: "unavailable" }` when the session cannot request input.
+
+`ask_question` is an [opt-in framework tool](/docs/concepts/built-in-tools#ask_question). Add it with `eve add tool/ask_question`, which creates this file:
+
+```ts title="agent/tools/ask_question.ts"
+import { askQuestion } from "eve/tools/ask_question";
+
+export default askQuestion();
+```
+
+`ask_question` is an ordinary [workflow tool](/docs/tools/workflows) built on `ctx.ask()`. Write your own workflow tool with `ctx.ask()` when you need a different schema or want to act on the answer in the same call. Without any asking tool, the model asks in its reply text and the user's next message carries the answer.
 
 ## How pause and resume works
 
 Approvals and questions share one protocol:
 
-1. The model requests input (an approval, or an `ask_question`).
+1. A tool call needs approval, or a workflow tool such as `ask_question` calls `ctx.ask()`.
 2. eve emits an `input.requested` stream event carrying the pending requests.
 3. The turn parks at `session.waiting`, durably, for as long as it takes.
 4. The client answers with `inputResponses` (structured, keyed by `requestId`) or a normal follow-up `message`. A follow-up whose text matches an option ID, option label, or numeric option index resolves automatically, including approval options such as `approve` and `cancel`.
 
+For `ctx.ask()` questions from blocking tools, a follow-up message answers the question only when exactly one question is pending. The message must match an option, or the question must allow free text. Otherwise the message reaches the model as a normal turn, and each pending question created with `dismissible: true` resolves as `dismissed`. Questions from background tools and subagents need a structured response.
+
 Each request includes a `kind` discriminator: `tool-approval`, `question`, or
-`session-limit`. Clients should use `kind` to choose behavior and presentation;
-`toolName` and `requestId` identify the action and request but do not encode its
-semantics.
+`session-limit`. Clients should use `kind` to choose behavior and presentation.
+`requestId` identifies the request to answer, and `action.callId` identifies the
+tool call that raised it; neither encodes the request's semantics.
 
 The run picks back up exactly where it parked. Because the pause is durable, nothing is held in memory while it waits — the process can restart and the parked turn survives.
 
@@ -189,7 +200,7 @@ From your own frontend, scan all messages for pending requests and answer throug
 ## What to read next
 
 - [Tools](/docs/tools): define the typed actions an approval gates
-- [Built-in tools](/docs/concepts/built-in-tools): the default tools, including `ask_question`
+- [Built-in tools](/docs/concepts/built-in-tools): the default tools and opt-in tools such as `ask_question`
 - [Sessions, runs & streaming](/docs/concepts/sessions-runs-and-streaming): the event and resume contract behind the pause
 - [Building a frontend](/docs/guides/frontend/overview): render and answer requests from your own UI
 - [Multi-tenant approvals](/docs/patterns/multi-tenant-approvals): resolve per-tenant approval policy for authored and connection tools