eve 0.31.3 → 0.33.0

package/CHANGELOG.md

@@ -1,5 +1,40 @@
 # eve
 
+## 0.33.0
+
+### Minor Changes
+
+- ccaa596: Dynamic models and subagents now resolve without compiled fallbacks or placeholder configs. `defineDynamic` accepts only `events`; dynamic model handlers must return a concrete selection, while runtime model metadata is normalized and cached when the selection becomes active.
+- 2dd193b: Channel message sends now use `turnPolicy: "steer"` by default, so accepted messages replace active turns through cancellation-backed steering without a separate cancel request. Set `turnPolicy: "queue"` on a channel or individual send to preserve the previous wait-for-completion behavior.
+
+### Patch Changes
+
+- 672c054: Add `eve set` with `--model` and `--reasoning` options for changing an existing agent's model settings, and add the same model settings to `eve init` for scaffolding.
+- 1ee27be: Interactive setup now offers an explicit exit after `eve init` and runs Vercel login and project linking in place whenever Vercel-backed integration setup or deployment needs them.
+
+## 0.32.0
+
+### Minor Changes
+
+- 1702f91: Tool approval responses now use `cancel` instead of `deny`, while retaining `approve` for the positive response, aligning the public protocol with the user-facing flow-control semantics.
+- cbe7105: Allow authored hooks, tools, and channel callbacks to stop their active sandbox through `ctx.getSandbox().stop()`. Every built-in backend preserves the durable session for a later callback, and custom sandbox backend handles must now implement `stop()`.
+
+### Patch Changes
+
+- ea530ec: Update `eve add` to better support agent-based invocation of guided setup flows. Interactive setup links a Vercel project when needed; after each deployable setup, `/add` offers to add more by default, deploy to production, or finish.
+- a29cc8e: Update the bundled AI SDK to 7.0.58 and the `@ai-sdk/*` providers to their latest minors.
+- 39c76ca: AI Gateway models now use Exa by default for the built-in `web_search` tool. Agents can continue to select Parallel explicitly with `webSearch({ provider: "parallel" })`.
+- 261af74: Photon setup now shows an existing project's dedicated number when available, rather than allocating and showing a shared fallback number.
+- 55b5cc7: Teach newly scaffolded coding agents to discover integrations and follow the structured `eve add --headless` setup flow through completion.
+- 91cca9a: Slack now posts tool input previews separately from approval controls so large inputs no longer inflate button callbacks and approvals remain responsive.
+- 50f2d96: Conversation sessions no longer stall while an interactive authorization challenge is open: ordinary messages run as normal turns, while tasks defer unrelated input until their blocked authorization completes. Callbacks are bound to the exact challenge attempt and initiating connection principal, remain live across parked activity, and start a valid callback turn after the authorization park closes its boundary. Session timeouts are also honored during an open challenge, and `client.fetch` preserves query strings embedded in the request path.
+- 7449917: Stop completed and cancelled todo lists from being re-injected as user messages after compaction. Lists that still contain active work continue to be preserved in full.
+- 63a76f0: Local traces now record `agent.turn` with the turn's real duration instead of a zero-duration marker, and the separate `agent.turn.terminal` marker span is gone — terminal and transition events land on the turn span itself. `agent.session` window roots remain zero-duration markers because an idle session never closes.
+- a159596: Export telemetry for every step of multi-step turns when an OpenTelemetry consumer groups spans by completed local segments.
+- e1080e0: Reject HTML sign-in pages returned by Slack private file downloads and explain how to restore attachment access.
+- 52000dd: Build tool input schemas authored with Zod 3 instead of crashing during JSON Schema conversion.
+- f06e12e: Add a structured `eve add --non-interactive` flow with stable setup answers, component selection, and resumable setup blockers for coding agents.
+
 ## 0.31.3
 
 ### Patch Changes
@@ -166,7 +201,7 @@
 ### Patch Changes
 
 - 22bfa02: Add guided Photon setup through `eve add channel/photon-imessage`, including project creation, phone registration, Vercel Connect or portable credentials, and channel scaffolding.
-- 0c0de19: Add an opt-in experimental steering policy to Chat SDK sends that cancels an active turn before delivering its replacement message.
+- 0c0de19: Add an opt-in steering policy to Chat SDK sends that cancels an active turn before delivering its replacement message.
 - b00a79d: Add `photonIMessageChannel`, a first-class Photon iMessage channel with lazy credentials, Vercel OIDC webhook verification, and automatic eve session routing.
 - 495e93b: Resolve leading `$HOME` paths in the built-in `read_file`, `write_file`, `glob`, and `grep` tools so agents can directly access packaged skill references advertised in their prompt.
 - bf01952: Local trace spans now capture model and tool payloads: the system prompt, prompt messages, and response text/reasoning/tool calls on model spans, and call arguments/results on tool spans, each capped at 32 KB with provider transport metadata stripped. Set `EVE_TRACES_CONTENT=off` to keep payloads out of the spool.

package/README.md

@@ -122,10 +122,13 @@ export default defineAgent({
 npx eve@latest init my-agent
 ```
 
-`eve init` writes a new agent with eve's default model. Pass `--channel-web-nextjs` to add the
-Web Chat application. It installs dependencies, initializes Git, and starts the
-development server. Targeting an existing project directory (`eve init .`) adds
-the agent files and missing dependencies instead. It does not create a Vercel
+`eve init` writes a new agent with eve's default model. Pass `--model
+openai/gpt-5.5` to choose another AI Gateway model, `--reasoning high` to set a
+reasoning effort, or `--channel-web-nextjs` to add the Web Chat application. It
+installs dependencies, initializes Git, and starts the development server. When
+it finds a supported coding-agent REPL, the handoff menu can open that REPL
+instead or exit. Targeting an existing project directory (`eve init .`) adds the
+agent files and missing dependencies instead. It does not create a Vercel
 project or deploy the agent.
 
 CLI commands:
@@ -135,6 +138,7 @@ CLI commands:
 - `eve build` — compile `.eve/` and build the host output
 - `eve start` — serve the built `.output/` app
 - `eve dev` — start the local runtime and REPL
+- `eve set [--model <model-id>] [--reasoning <effort>]` — change root model settings
 - `eve extension init <name>` — create a new extension package
 - `eve extension build` — build an extension package
 

package/dist/src/channel/channel-address.d.ts

@@ -2,7 +2,7 @@ import type { UserContent } from "ai";
 import type { ChannelAdapter } from "#channel/adapter.js";
 import type { SendPayload } from "#channel/routes.js";
 import { type Session } from "#channel/session.js";
-import type { CancelTurnResult, ClearSessionResult, CompactSessionResult, ResetSessionResult, Runtime, SessionAuthContext, SessionCallback } from "#channel/types.js";
+import type { CancelTurnResult, ClearSessionResult, CompactSessionResult, ResetSessionResult, Runtime, SessionAuthContext, SessionCallback, TurnPolicy } from "#channel/types.js";
 import type { RunMode } from "#shared/run-mode.js";
 interface BaseChannelAddressDeliveryOptions {
     readonly auth: SessionAuthContext | null;
@@ -10,6 +10,7 @@ interface BaseChannelAddressDeliveryOptions {
     readonly initiatorAuth?: SessionAuthContext | null;
     readonly mode?: RunMode;
     readonly title?: string;
+    readonly turnPolicy?: TurnPolicy;
 }
 /** Delivery options for a channel address whose continuation token is already bound. */
 export type ChannelAddressDeliveryOptions<TState = undefined> = [TState] extends [undefined] ? BaseChannelAddressDeliveryOptions : BaseChannelAddressDeliveryOptions & {
@@ -45,6 +46,7 @@ export declare function createChannelAddress<TState = undefined>(input: {
         readonly requestId?: string;
     };
     readonly runtime: Runtime;
+    readonly turnPolicy?: TurnPolicy;
 }): ChannelAddress<TState>;
 /** Builds a request-scoped factory for channel addresses on one authored channel. */
 export declare function createChannelAddressFn<TState = undefined>(input: {
@@ -54,5 +56,6 @@ export declare function createChannelAddressFn<TState = undefined>(input: {
         readonly requestId?: string;
     };
     readonly runtime: Runtime;
+    readonly turnPolicy?: TurnPolicy;
 }): ChannelAddressFn<TState>;
 export {};

package/dist/src/channel/channel-address.js

@@ -1 +1 @@
-import{createSession,sessionCallbackToTurnCaller}from"#channel/session.js";import{normalizeSendInput,serializeUrlFilePartsInMessage}from"#channel/send-input.js";import{isRuntimeSessionOwnershipConflictError}from"#execution/runtime-errors.js";import{isReservedSessionCommandToken}from"#execution/session-command-token.js";function createChannelAddress(r){let i=r.metadata??{},a=`${r.channelName}:${r.continuationToken}`;if(isReservedSessionCommandToken(a))throw Error(`Channel address "${a}" uses eve's reserved session namespace.`);return{continuationToken:r.continuationToken,async deliver(n,o){let s=normalizeSendInput(n),c=sessionCallbackToTurnCaller(o.callback),l={auth:o.auth,kind:`send`,payload:{...s,message:serializeUrlFilePartsInMessage(s.message)},requestId:i.requestId},u=c===void 0?l:{...l,caller:c},dispatch=async()=>{let t=await r.runtime.dispatchContinuation({command:u,continuationToken:a});return t.status===`accepted`?createSession(t.sessionId,r.runtime,i):void 0},d=await dispatch();if(d!==void 0)return d;if(s.inputResponses&&s.inputResponses.length>0)throw Error(`Cannot deliver inputResponses — the target session was not found via continuation token.`);let f=o.state,p={adapter:f===void 0?r.adapter:{...r.adapter,state:{...r.adapter.state,...f}},auth:o.auth,capabilities:o.mode===`task`?void 0:{requestInput:!0},callback:o.callback,channelName:r.channelName,continuationToken:a,initiatorAuth:o.initiatorAuth,input:{context:s.context,message:serializeUrlFilePartsInMessage(s.message)??``,outputSchema:s.outputSchema},mode:o.mode??`conversation`,requestId:i.requestId,title:o.title};try{return createSession((await r.runtime.createSession(p)).sessionId,r.runtime,i)}catch(e){if(!isRuntimeSessionOwnershipConflictError(e))throw e;let t=await dispatch();if(t!==void 0)return t;throw e}},async send(e,t){return await this.deliver({message:e},t)},async respond(e,t){if(e===void 0||e.length===0)throw Error(`respond() requires at least one input response.`);return await this.deliver({inputResponses:e},t)},async cancel(e){return await r.runtime.dispatchContinuation({command:{kind:`cancel`,turnId:e?.turnId},continuationToken:a})},async compact(){return await r.runtime.dispatchContinuation({command:{kind:`compact`},continuationToken:a})},async clear(){return await r.runtime.dispatchContinuation({command:{kind:`clear`},continuationToken:a})},async reset(e){return await r.runtime.dispatchContinuation({command:{kind:`reset`,reason:e?.reason},continuationToken:a})},async resolveSession(){let t=await r.runtime.resolveContinuation(a);return t===void 0?void 0:createSession(t.sessionId,r.runtime,i)}}}function createChannelAddressFn(e){return t=>createChannelAddress({...e,continuationToken:t})}export{createChannelAddress,createChannelAddressFn};
+import{createSession,sessionCallbackToTurnCaller}from"#channel/session.js";import{normalizeSendInput,serializeUrlFilePartsInMessage}from"#channel/send-input.js";import{DEFAULT_TURN_POLICY}from"#channel/types.js";import{isRuntimeSessionOwnershipConflictError}from"#execution/runtime-errors.js";import{isReservedSessionCommandToken}from"#execution/session-command-token.js";function createChannelAddress(r){let i=r.metadata??{},a=`${r.channelName}:${r.continuationToken}`;if(isReservedSessionCommandToken(a))throw Error(`Channel address "${a}" uses eve's reserved session namespace.`);return{continuationToken:r.continuationToken,async deliver(n,o){let s=normalizeSendInput(n),c=sessionCallbackToTurnCaller(o.callback),l={auth:o.auth,kind:`send`,payload:{...s,message:serializeUrlFilePartsInMessage(s.message)},requestId:i.requestId,turnPolicy:s.message===void 0?void 0:o.turnPolicy??r.turnPolicy??DEFAULT_TURN_POLICY},u=c===void 0?l:{...l,caller:c},dispatch=async()=>{let t=await r.runtime.dispatchContinuation({command:u,continuationToken:a});return t.status===`accepted`?createSession(t.sessionId,r.runtime,{...i,turnPolicy:r.turnPolicy}):void 0},d=await dispatch();if(d!==void 0)return d;if(s.inputResponses&&s.inputResponses.length>0)throw Error(`Cannot deliver inputResponses — the target session was not found via continuation token.`);let f=o.state,p={adapter:f===void 0?r.adapter:{...r.adapter,state:{...r.adapter.state,...f}},auth:o.auth,capabilities:o.mode===`task`?void 0:{requestInput:!0},callback:o.callback,channelName:r.channelName,continuationToken:a,initiatorAuth:o.initiatorAuth,input:{context:s.context,message:serializeUrlFilePartsInMessage(s.message)??``,outputSchema:s.outputSchema},mode:o.mode??`conversation`,requestId:i.requestId,title:o.title};try{return createSession((await r.runtime.createSession(p)).sessionId,r.runtime,{...i,turnPolicy:r.turnPolicy})}catch(e){if(!isRuntimeSessionOwnershipConflictError(e))throw e;let t=await dispatch();if(t!==void 0)return t;throw e}},async send(e,t){return await this.deliver({message:e},t)},async respond(e,t){if(e===void 0||e.length===0)throw Error(`respond() requires at least one input response.`);return await this.deliver({inputResponses:e},t)},async cancel(e){return await r.runtime.dispatchContinuation({command:{kind:`cancel`,turnId:e?.turnId},continuationToken:a})},async compact(){return await r.runtime.dispatchContinuation({command:{kind:`compact`},continuationToken:a})},async clear(){return await r.runtime.dispatchContinuation({command:{kind:`clear`},continuationToken:a})},async reset(e){return await r.runtime.dispatchContinuation({command:{kind:`reset`,reason:e?.reason},continuationToken:a})},async resolveSession(){let t=await r.runtime.resolveContinuation(a);return t===void 0?void 0:createSession(t.sessionId,r.runtime,{...i,turnPolicy:r.turnPolicy})}}}function createChannelAddressFn(e){return t=>createChannelAddress({...e,continuationToken:t})}export{createChannelAddress,createChannelAddressFn};

package/dist/src/channel/channel-operations.d.ts

@@ -3,7 +3,7 @@ import type { ChannelAdapter } from "#channel/adapter.js";
 import { type ChannelAddressDeliveryOptions } from "#channel/channel-address.js";
 import type { SendPayload } from "#channel/routes.js";
 import type { Session } from "#channel/session.js";
-import type { CancelTurnResult, ClearSessionResult, CompactSessionResult, ResetSessionResult, Runtime, SessionAuthContext, SessionCallback } from "#channel/types.js";
+import type { CancelTurnResult, ClearSessionResult, CompactSessionResult, ResetSessionResult, Runtime, SessionAuthContext, SessionCallback, TurnPolicy } from "#channel/types.js";
 import type { InputResponse } from "#runtime/input/types.js";
 import type { JsonObject } from "#shared/json.js";
 import type { RunMode } from "#shared/run-mode.js";
@@ -15,6 +15,7 @@ interface BaseChannelSendOptions {
     readonly mode?: RunMode;
     readonly outputSchema?: JsonObject;
     readonly title?: string;
+    readonly turnPolicy?: TurnPolicy;
 }
 /** Options for sending a message from a channel-local continuation address. */
 export type ChannelSendOptions<TState = undefined> = [TState] extends [undefined] ? BaseChannelSendOptions : BaseChannelSendOptions & {
@@ -68,5 +69,6 @@ export declare function createChannelOperations<TState = undefined>(input: {
         readonly requestId?: string;
     };
     readonly runtime: Runtime;
+    readonly turnPolicy?: TurnPolicy;
 }): ChannelReceiveContext<TState>;
 export {};

package/dist/src/channel/compiled-channel.d.ts

@@ -5,7 +5,7 @@ import type { NormalizedChannelCorsOptions } from "#channel/cors.js";
 import type { TypedReceiveTarget } from "#channel/receive-target.js";
 import type { RouteDefinition } from "#channel/routes.js";
 import type { Session } from "#channel/session.js";
-import type { SessionAuthContext } from "#channel/types.js";
+import type { SessionAuthContext, TurnPolicy } from "#channel/types.js";
 export declare const CHANNEL_SENTINEL: "eve:channel";
 /** Structural identity shared by public authored channels and compiled channels. */
 export interface ChannelReference<TReceiveTarget = Record<string, unknown>> extends TypedReceiveTarget<TReceiveTarget> {
@@ -21,6 +21,7 @@ export interface CompiledChannel<TState = undefined, TReceiveTarget = Record<str
         readonly target: Readonly<TReceiveTarget>;
         readonly auth: SessionAuthContext | null;
     }, ctx: ChannelReceiveContext<TState>) => Promise<Session>;
+    readonly turnPolicy?: TurnPolicy;
 }
 export declare function isCompiledChannel(value: unknown): value is CompiledChannel;
 export declare function getChannelInstrumentationKind(value: unknown): string | undefined;

package/dist/src/channel/cross-channel-receive.d.ts

@@ -3,13 +3,14 @@ import type { ChannelAdapter } from "#channel/adapter.js";
 import { type ChannelReference, type CompiledChannel } from "#channel/compiled-channel.js";
 import type { InferReceiveTarget } from "#channel/receive-target.js";
 import type { Session } from "#channel/session.js";
-import type { Runtime, SessionAuthContext } from "#channel/types.js";
+import type { Runtime, SessionAuthContext, TurnPolicy } from "#channel/types.js";
 import type { ResolvedChannelDefinition } from "#runtime/types.js";
 /**
  * Options for sending a message to a channel selected with `ctx.to(...)`.
  */
 export interface CrossChannelSendOptions {
     readonly auth: SessionAuthContext | null;
+    readonly turnPolicy?: TurnPolicy;
 }
 /** Message delivery bound to one channel-specific proactive target. */
 export interface CrossChannelTargetHandle {
@@ -27,6 +28,7 @@ export interface CrossChannelTarget {
     readonly definition: CompiledChannel;
     readonly receive?: CompiledChannel["receive"];
     readonly adapter?: ChannelAdapter;
+    readonly turnPolicy?: CompiledChannel["turnPolicy"];
 }
 /**
  * Projects an agent's resolved channels into the receiver-input shape.
@@ -42,12 +44,13 @@ export declare function toCrossChannelTargets(channels: readonly ResolvedChannel
 export declare function createCrossChannelToFn(runtime: Runtime, channels: readonly CrossChannelTarget[]): CrossChannelToFn;
 interface InvokeChannelReceiveInput {
     readonly runtime: Runtime;
-    readonly target: Pick<CrossChannelTarget, "name" | "receive" | "adapter">;
+    readonly target: Pick<CrossChannelTarget, "name" | "receive" | "adapter" | "turnPolicy">;
     readonly input: {
         readonly message: string | UserContent;
         readonly target: Readonly<Record<string, unknown>>;
         readonly auth: SessionAuthContext | null;
     };
+    readonly turnPolicy?: TurnPolicy;
     readonly describeMissingReceive: () => string;
     readonly describeMissingAdapter: () => string;
 }

package/dist/src/channel/cross-channel-receive.js

@@ -1,2 +1,2 @@
-import{createChannelOperations}from"#channel/channel-operations.js";import{isCompiledChannel}from"#channel/compiled-channel.js";function toCrossChannelTargets(e){return e.flatMap(e=>e.definition===void 0?[]:[{name:e.name,definition:e.definition,receive:e.receive,adapter:e.adapter}])}function createCrossChannelToFn(e,t){return(n,r)=>{let i=resolveTargetByReference(n,t);return{async send(t,n){return await invokeChannelReceive({runtime:e,target:i,input:{message:t,target:r,auth:n.auth},describeMissingReceive:()=>`ctx.to(): channel "${i.name}" does not implement receive(). Declare a receive hook on the channel to accept cross-channel sessions.`,describeMissingAdapter:()=>`ctx.to(): channel "${i.name}" has no adapter — cannot build ctx.from().`})}}}}async function invokeChannelReceive(t){if(!t.target.receive)throw Error(t.describeMissingReceive());if(!t.target.adapter)throw Error(t.describeMissingAdapter());let n=createChannelOperations({adapter:t.target.adapter,channelName:t.target.name,runtime:t.runtime});return await t.target.receive(t.input,n)}function resolveTargetByReference(e,t){for(let n of t)if(n.definition===e)return n;let n=resolveTargetByRouteFingerprint(e,t);if(n!==null)return n;throw Error(`ctx.to(): the channel passed as the first argument is not registered in this agent's channels/. Import the channel module's default export from agent/channels/<name>.ts and pass that value.`)}function resolveTargetByRouteFingerprint(e,n){if(!isCompiledChannel(e))return null;let r=createRouteFingerprint(e);if(r===null)return null;let i=new Map;for(let e of n)createRouteFingerprint(e.definition)===r&&i.set(e.name,e);if(i.size===1)return[...i.values()][0];if(i.size>1)throw Error(`ctx.to(): the channel passed as the first argument matches multiple registered channels by route shape. Import a channel with a unique route set from agent/channels/<name>.ts before passing it to ctx.to().`);return null}function createRouteFingerprint(e){return e.routes.length===0?null:e.routes.map(e=>`${e.method.toUpperCase()} ${e.path}`).sort().join(`
+import{createChannelOperations}from"#channel/channel-operations.js";import{isCompiledChannel}from"#channel/compiled-channel.js";function toCrossChannelTargets(e){return e.flatMap(e=>e.definition===void 0?[]:[{name:e.name,definition:e.definition,receive:e.receive,adapter:e.adapter,turnPolicy:e.turnPolicy}])}function createCrossChannelToFn(e,t){return(n,r)=>{let i=resolveTargetByReference(n,t);return{async send(t,n){return await invokeChannelReceive({runtime:e,target:i,input:{message:t,target:r,auth:n.auth},turnPolicy:n.turnPolicy,describeMissingReceive:()=>`ctx.to(): channel "${i.name}" does not implement receive(). Declare a receive hook on the channel to accept cross-channel sessions.`,describeMissingAdapter:()=>`ctx.to(): channel "${i.name}" has no adapter — cannot build ctx.from().`})}}}}async function invokeChannelReceive(t){if(!t.target.receive)throw Error(t.describeMissingReceive());if(!t.target.adapter)throw Error(t.describeMissingAdapter());let n=createChannelOperations({adapter:t.target.adapter,channelName:t.target.name,runtime:t.runtime,turnPolicy:t.turnPolicy??t.target.turnPolicy});return await t.target.receive(t.input,n)}function resolveTargetByReference(e,t){for(let n of t)if(n.definition===e)return n;let n=resolveTargetByRouteFingerprint(e,t);if(n!==null)return n;throw Error(`ctx.to(): the channel passed as the first argument is not registered in this agent's channels/. Import the channel module's default export from agent/channels/<name>.ts and pass that value.`)}function resolveTargetByRouteFingerprint(e,n){if(!isCompiledChannel(e))return null;let r=createRouteFingerprint(e);if(r===null)return null;let i=new Map;for(let e of n)createRouteFingerprint(e.definition)===r&&i.set(e.name,e);if(i.size===1)return[...i.values()][0];if(i.size>1)throw Error(`ctx.to(): the channel passed as the first argument matches multiple registered channels by route shape. Import a channel with a unique route set from agent/channels/<name>.ts before passing it to ctx.to().`);return null}function createRouteFingerprint(e){return e.routes.length===0?null:e.routes.map(e=>`${e.method.toUpperCase()} ${e.path}`).sort().join(`
 `)}export{createCrossChannelToFn,invokeChannelReceive,toCrossChannelTargets};

package/dist/src/channel/session.d.ts

@@ -1,7 +1,7 @@
 import type { ContextAccessor } from "#context/key.js";
 import type { MessageStreamEvent } from "#protocol/message.js";
 import type { UserContent } from "ai";
-import type { CancelTurnResult, ClearSessionResult, CompactSessionResult, ResetSessionResult, Runtime, SessionAuthContext, SessionCallback, SessionSendCommandResult, TurnCaller } from "#channel/types.js";
+import type { CancelTurnResult, ClearSessionResult, CompactSessionResult, ResetSessionResult, Runtime, SessionAuthContext, SessionCallback, SessionSendCommandResult, TurnPolicy, TurnCaller } from "#channel/types.js";
 import type { SessionAuth } from "#context/keys.js";
 import type { InputResponse } from "#runtime/input/types.js";
 import type { JsonObject } from "#shared/json.js";
@@ -37,7 +37,9 @@ interface SessionDeliveryOptions {
     readonly outputSchema?: JsonObject;
 }
 /** Options for sending a message through a fixed session handle. */
-export type SessionSendOptions = SessionDeliveryOptions;
+export type SessionSendOptions = SessionDeliveryOptions & {
+    readonly turnPolicy?: TurnPolicy;
+};
 /** Options for answering pending input requests through a fixed session handle. */
 export type SessionRespondOptions = SessionDeliveryOptions;
 /**
@@ -57,10 +59,12 @@ export interface SessionHandle {
 }
 export declare function createSession(id: string, runtime: Runtime, metadata?: {
     readonly requestId?: string;
+    readonly turnPolicy?: TurnPolicy;
 }): Session;
 /** Builds an I/O-free factory for fixed session-ID handles. */
 export declare function createAttachSessionFn(runtime: Runtime, metadata?: {
     readonly requestId?: string;
+    readonly turnPolicy?: TurnPolicy;
 }): (sessionId: string) => Session;
 /**
  * Builds a live {@link SessionHandle} backed by the active context

package/dist/src/channel/session.js

@@ -1 +1 @@
-import{serializeUrlFilePartsInMessage}from"#channel/send-input.js";import{AuthKey,ContinuationTokenKey,InitiatorAuthKey,SessionIdKey}from"#context/keys.js";import{toChannelLocalContinuationToken}from"#shared/continuation-token.js";function createSession(t,n,r={}){return{id:t,async send(i,a){let o=sessionCallbackToTurnCaller(a.callback),s={message:serializeUrlFilePartsInMessage(i)};a.context!==void 0&&(s.context=a.context),a.outputSchema!==void 0&&(s.outputSchema=a.outputSchema);let c={auth:a.auth,kind:`send`,payload:s,requestId:r.requestId};return await n.dispatchSession({command:o===void 0?c:{...c,caller:o},sessionId:t})},async respond(e,i){if(e.length===0)throw Error(`respond() requires at least one input response.`);let a=sessionCallbackToTurnCaller(i.callback),o={inputResponses:e};i.context!==void 0&&(o.context=i.context),i.outputSchema!==void 0&&(o.outputSchema=i.outputSchema);let s={auth:i.auth,kind:`send`,payload:o,requestId:r.requestId};return await n.dispatchSession({command:a===void 0?s:{...s,caller:a},sessionId:t})},async cancel(e){return await n.dispatchSession({command:{kind:`cancel`,turnId:e?.turnId},sessionId:t})},async compact(){return await n.dispatchSession({command:{kind:`compact`},sessionId:t})},async clear(){return await n.dispatchSession({command:{kind:`clear`},sessionId:t})},async reset(e){return await n.dispatchSession({command:{kind:`reset`,reason:e?.reason},sessionId:t})},async getEventStream(e){return n.getEventStream(t,e)},async getStreamTailIndex(){return n.getStreamTailIndex(t)}}}function createAttachSessionFn(e,t={}){return n=>createSession(n,e,t)}function buildSessionHandle(e){return{get id(){return e.get(SessionIdKey)??``},get auth(){return{current:e.get(AuthKey)??null,initiator:e.get(InitiatorAuthKey)??null}},get continuation(){let t=e.get(ContinuationTokenKey);if(!(t===void 0||t.length===0))return{token:toChannelLocalContinuationToken(t),rekey(r){let i=namespaceContinuationToken(t,r);t!==i&&e.set(ContinuationTokenKey,i)}}}}}function namespaceContinuationToken(e,t){let n=e.indexOf(`:`);if(n<=0)throw Error(`Cannot set session continuation token without an existing namespaced continuation token. Start the session with a placeholder continuationToken.`);return`${e.slice(0,n+1)}${t}`}function sessionCallbackToTurnCaller(e){return e===void 0?void 0:{callId:e.callId,replyTo:{kind:`callback`,url:e.url},subagentName:e.subagentName}}export{buildSessionHandle,createAttachSessionFn,createSession,sessionCallbackToTurnCaller};
+import{serializeUrlFilePartsInMessage}from"#channel/send-input.js";import{DEFAULT_TURN_POLICY}from"#channel/types.js";import{AuthKey,ContinuationTokenKey,InitiatorAuthKey,SessionIdKey}from"#context/keys.js";import{toChannelLocalContinuationToken}from"#shared/continuation-token.js";function createSession(n,r,i={}){return{id:n,async send(a,o){let s=sessionCallbackToTurnCaller(o.callback),c={message:serializeUrlFilePartsInMessage(a)};o.context!==void 0&&(c.context=o.context),o.outputSchema!==void 0&&(c.outputSchema=o.outputSchema);let l={auth:o.auth,kind:`send`,payload:c,requestId:i.requestId,turnPolicy:o.turnPolicy??i.turnPolicy??DEFAULT_TURN_POLICY};return await r.dispatchSession({command:s===void 0?l:{...l,caller:s},sessionId:n})},async respond(e,t){if(e.length===0)throw Error(`respond() requires at least one input response.`);let a=sessionCallbackToTurnCaller(t.callback),o={inputResponses:e};t.context!==void 0&&(o.context=t.context),t.outputSchema!==void 0&&(o.outputSchema=t.outputSchema);let s={auth:t.auth,kind:`send`,payload:o,requestId:i.requestId};return await r.dispatchSession({command:a===void 0?s:{...s,caller:a},sessionId:n})},async cancel(e){return await r.dispatchSession({command:{kind:`cancel`,turnId:e?.turnId},sessionId:n})},async compact(){return await r.dispatchSession({command:{kind:`compact`},sessionId:n})},async clear(){return await r.dispatchSession({command:{kind:`clear`},sessionId:n})},async reset(e){return await r.dispatchSession({command:{kind:`reset`,reason:e?.reason},sessionId:n})},async getEventStream(e){return r.getEventStream(n,e)},async getStreamTailIndex(){return r.getStreamTailIndex(n)}}}function createAttachSessionFn(e,t={}){return n=>createSession(n,e,t)}function buildSessionHandle(e){return{get id(){return e.get(SessionIdKey)??``},get auth(){return{current:e.get(AuthKey)??null,initiator:e.get(InitiatorAuthKey)??null}},get continuation(){let t=e.get(ContinuationTokenKey);if(!(t===void 0||t.length===0))return{token:toChannelLocalContinuationToken(t),rekey(n){let i=namespaceContinuationToken(t,n);t!==i&&e.set(ContinuationTokenKey,i)}}}}}function namespaceContinuationToken(e,t){let n=e.indexOf(`:`);if(n<=0)throw Error(`Cannot set session continuation token without an existing namespaced continuation token. Start the session with a placeholder continuationToken.`);return`${e.slice(0,n+1)}${t}`}function sessionCallbackToTurnCaller(e){return e===void 0?void 0:{callId:e.callId,replyTo:{kind:`callback`,url:e.url},subagentName:e.subagentName}}export{buildSessionHandle,createAttachSessionFn,createSession,sessionCallbackToTurnCaller};

package/dist/src/channel/types.d.ts

@@ -125,6 +125,10 @@ export interface DeliverPayload {
     readonly outputSchema?: JsonObject;
     readonly [key: string]: unknown;
 }
+/** Controls how a channel message interacts with an active turn. */
+export type TurnPolicy = "steer" | "queue";
+/** Default policy for message sends produced by current channel surfaces. */
+export declare const DEFAULT_TURN_POLICY: TurnPolicy;
 /** One command accepted by a durable session inbox. */
 export type SessionCommand = {
     readonly auth?: SessionAuthContext | null;
@@ -132,6 +136,7 @@ export type SessionCommand = {
     readonly kind: "send";
     readonly payload: DeliverPayload;
     readonly requestId?: string;
+    readonly turnPolicy?: TurnPolicy;
 } | {
     readonly kind: "cancel";
     readonly turnId?: string;
@@ -187,6 +192,7 @@ export interface DeliverHookPayload {
     readonly requestId?: string;
     readonly kind: "deliver";
     readonly payloads: readonly DeliverPayload[];
+    readonly turnPolicy?: TurnPolicy;
 }
 /** Internal deadline signal sent through the stable session command inbox. */
 export interface SessionTimeoutHookPayload {

package/dist/src/channel/types.js

@@ -1 +1 @@
-export{};
+const DEFAULT_TURN_POLICY=`steer`;export{DEFAULT_TURN_POLICY};

package/dist/src/chunks/{use-eve-agent-CF5D6jSV.js → use-eve-agent-3oBnxzhV.js}

@@ -1,5 +1,6 @@
 import { computed, onScopeDispose, shallowRef } from "vue";
 import { z } from "#compiled/zod/index.js";
+import { asSchema } from "ai";
 
 //#region src/protocol/routes.ts
 const EVE_ROUTE_PREFIX = "/eve/v1";
@@ -17,7 +18,8 @@ const EVE_DEV_RUNTIME_ARTIFACTS_ROUTE_PATH = `${EVE_ROUTE_PREFIX}/dev/runtime-ar
 const EVE_DEV_RUNTIME_ARTIFACTS_REBUILD_ROUTE_PATH = `${EVE_DEV_RUNTIME_ARTIFACTS_ROUTE_PATH}/rebuild`;
 const EVE_DEV_RUNTIME_ARTIFACTS_SUSPEND_ROUTE_PATH = `${EVE_DEV_RUNTIME_ARTIFACTS_ROUTE_PATH}/suspend`;
 const EVE_DEV_RUNTIME_ARTIFACTS_RESUME_ROUTE_PATH = `${EVE_DEV_RUNTIME_ARTIFACTS_ROUTE_PATH}/resume`;
-const EVE_CONNECTION_CALLBACK_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/connections/:name/callback/:token`;
+const EVE_CONNECTION_CALLBACK_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/connections/:name/callback/:attemptId/:token`;
+const EVE_LEGACY_CONNECTION_CALLBACK_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/connections/:name/callback/:token`;
 const EVE_CALLBACK_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/callback/:token`;
 function createEveSessionRoutePath(sessionId) {
 	return `${EVE_SESSION_ROUTE_PATH}/${encodeURIComponent(sessionId)}`;
@@ -90,6 +92,31 @@ const modelEndpoint = z.union([
 		connected: z.literal(false)
 	})
 ]);
+const agentModelBaseFields = {
+	contextWindowTokens: z.number().optional(),
+	providerOptions: z.unknown().optional(),
+	reasoning: z.enum([
+		"provider-default",
+		"none",
+		"minimal",
+		"low",
+		"medium",
+		"high",
+		"xhigh"
+	]).optional().catch(void 0),
+	source: source.optional()
+};
+const agentModel = z.union([z.object({
+	...agentModelBaseFields,
+	id: z.string(),
+	routing: modelRouting,
+	endpoint: modelEndpoint.optional()
+}).strict(), z.object({
+	...agentModelBaseFields,
+	endpoint: z.never().optional(),
+	id: z.never().optional(),
+	routing: z.object({ kind: z.literal("dynamic") }).strict()
+}).strict()]);
 const tool = entry.extend({
 	description: z.string(),
 	hasAuth: z.boolean(),
@@ -186,23 +213,7 @@ const AgentInfoResultSchema = z.object({
 		appRoot: z.string(),
 		configSource: source.optional(),
 		description: z.string().optional(),
-		model: z.object({
-			contextWindowTokens: z.number().optional(),
-			id: z.string(),
-			providerOptions: z.unknown().optional(),
-			reasoning: z.enum([
-				"provider-default",
-				"none",
-				"minimal",
-				"low",
-				"medium",
-				"high",
-				"xhigh"
-			]).optional().catch(void 0),
-			source: source.optional(),
-			routing: modelRouting.optional(),
-			endpoint: modelEndpoint.optional()
-		}),
+		model: agentModel,
 		name: z.string(),
 		outputSchema: z.unknown().optional()
 	}),
@@ -503,19 +514,28 @@ async function* readNdjsonStream(body) {
 //#endregion
 //#region src/client/url.ts
 function createClientUrl(host, routePath, searchParams) {
-	const normalizedRoute = routePath.startsWith("/") ? routePath : `/${routePath}`;
+	const queryIndex = routePath.indexOf("?");
+	const pathOnly = queryIndex === -1 ? routePath : routePath.slice(0, queryIndex);
+	const embeddedQuery = queryIndex === -1 ? "" : routePath.slice(queryIndex + 1);
+	const normalizedRoute = pathOnly.startsWith("/") ? pathOnly : `/${pathOnly}`;
 	if (isAbsoluteUrl(host)) {
 		const url = new URL(host);
 		url.pathname = `${trimTrailingSlash(url.pathname)}${normalizedRoute}`;
+		mergeEmbeddedQuery(url.searchParams, embeddedQuery);
 		mergeSearchParams(url.searchParams, searchParams);
 		url.hash = "";
 		return url.toString();
 	}
 	const url = new URL(host, "http://eve.local");
 	const basePath = trimTrailingSlash(url.pathname);
+	mergeEmbeddedQuery(url.searchParams, embeddedQuery);
 	mergeSearchParams(url.searchParams, searchParams);
 	return `${basePath}${normalizedRoute}${formatSearch(url.searchParams)}`;
 }
+function mergeEmbeddedQuery(target, embeddedQuery) {
+	if (embeddedQuery.length === 0) return;
+	for (const [name, value] of new URLSearchParams(embeddedQuery)) target.append(name, value);
+}
 function isAbsoluteUrl(value) {
 	return /^[a-z][a-z\d+\-.]*:/i.test(value);
 }
@@ -888,11 +908,25 @@ function serializeSchema(source, direction) {
 	return toJsonObject(source, direction);
 }
 function toJsonObject(source, direction) {
-	const { $schema: _schemaVersion, ...canonical } = isStandardJsonSchema(source) ? parseJsonObject(source["~standard"].jsonSchema[direction]({ target: JSON_SCHEMA_TARGET })) : parseJsonObject(source);
+	const standard = getStandardSchemaProperties(source);
+	const jsonSchema = standard?.jsonSchema;
+	const emit = typeof jsonSchema === "object" && jsonSchema !== null ? jsonSchema[direction] : void 0;
+	const vendor = typeof standard?.vendor === "string" ? standard.vendor : "unknown";
+	if (standard !== void 0 && typeof emit !== "function" && vendor === "zod") {
+		if (direction === "input") {
+			const { $schema: _schemaVersion, ...canonical } = parseJsonObject(asSchema(source).jsonSchema);
+			return canonical;
+		}
+		throw new Error("Zod 3 cannot emit an output JSON Schema. Upgrade to Zod 4 or provide a plain JSON Schema object.");
+	}
+	if (standard !== void 0 && typeof emit !== "function") throw new Error(`Standard Schema vendor "${vendor}" does not support JSON Schema conversion. Provide a Standard Schema implementation with JSON Schema conversion or a plain JSON Schema object.`);
+	const { $schema: _schemaVersion, ...canonical } = standard === void 0 ? parseJsonObject(source) : parseJsonObject(emit({ target: JSON_SCHEMA_TARGET }));
 	return canonical;
 }
-function isStandardJsonSchema(value) {
-	return value !== null && typeof value === "object" && "~standard" in value;
+function getStandardSchemaProperties(value) {
+	if (typeof value !== "object" || value === null || !("~standard" in value)) return void 0;
+	const standard = value["~standard"];
+	return typeof standard === "object" && standard !== null ? standard : void 0;
 }
 
 //#endregion
@@ -1073,6 +1107,7 @@ function createMessageBody(input, requireMessage) {
 	const body = {};
 	if (input.message !== void 0) body.message = input.message;
 	if (input.inputResponses !== void 0 && input.inputResponses.length > 0) body.inputResponses = input.inputResponses;
+	if (!requireMessage && input.message !== void 0 && input.turnPolicy !== void 0) body.turnPolicy = input.turnPolicy;
 	if (input.clientContext !== void 0) body.clientContext = input.clientContext;
 	const outputSchema = serializeOutputSchema(input.outputSchema);
 	if (outputSchema !== void 0) body.outputSchema = outputSchema;

package/dist/src/chunks/{use-eve-agent-DbYZLG0h.js → use-eve-agent-B-Hky2f4.js}

@@ -1,5 +1,6 @@
 import { createSubscriber } from "svelte/reactivity";
 import { z } from "#compiled/zod/index.js";
+import { asSchema } from "ai";
 
 //#region src/protocol/routes.ts
 const EVE_ROUTE_PREFIX = "/eve/v1";
@@ -17,7 +18,8 @@ const EVE_DEV_RUNTIME_ARTIFACTS_ROUTE_PATH = `${EVE_ROUTE_PREFIX}/dev/runtime-ar
 const EVE_DEV_RUNTIME_ARTIFACTS_REBUILD_ROUTE_PATH = `${EVE_DEV_RUNTIME_ARTIFACTS_ROUTE_PATH}/rebuild`;
 const EVE_DEV_RUNTIME_ARTIFACTS_SUSPEND_ROUTE_PATH = `${EVE_DEV_RUNTIME_ARTIFACTS_ROUTE_PATH}/suspend`;
 const EVE_DEV_RUNTIME_ARTIFACTS_RESUME_ROUTE_PATH = `${EVE_DEV_RUNTIME_ARTIFACTS_ROUTE_PATH}/resume`;
-const EVE_CONNECTION_CALLBACK_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/connections/:name/callback/:token`;
+const EVE_CONNECTION_CALLBACK_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/connections/:name/callback/:attemptId/:token`;
+const EVE_LEGACY_CONNECTION_CALLBACK_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/connections/:name/callback/:token`;
 const EVE_CALLBACK_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/callback/:token`;
 function createEveSessionRoutePath(sessionId) {
 	return `${EVE_SESSION_ROUTE_PATH}/${encodeURIComponent(sessionId)}`;
@@ -90,6 +92,31 @@ const modelEndpoint = z.union([
 		connected: z.literal(false)
 	})
 ]);
+const agentModelBaseFields = {
+	contextWindowTokens: z.number().optional(),
+	providerOptions: z.unknown().optional(),
+	reasoning: z.enum([
+		"provider-default",
+		"none",
+		"minimal",
+		"low",
+		"medium",
+		"high",
+		"xhigh"
+	]).optional().catch(void 0),
+	source: source.optional()
+};
+const agentModel = z.union([z.object({
+	...agentModelBaseFields,
+	id: z.string(),
+	routing: modelRouting,
+	endpoint: modelEndpoint.optional()
+}).strict(), z.object({
+	...agentModelBaseFields,
+	endpoint: z.never().optional(),
+	id: z.never().optional(),
+	routing: z.object({ kind: z.literal("dynamic") }).strict()
+}).strict()]);
 const tool = entry.extend({
 	description: z.string(),
 	hasAuth: z.boolean(),
@@ -186,23 +213,7 @@ const AgentInfoResultSchema = z.object({
 		appRoot: z.string(),
 		configSource: source.optional(),
 		description: z.string().optional(),
-		model: z.object({
-			contextWindowTokens: z.number().optional(),
-			id: z.string(),
-			providerOptions: z.unknown().optional(),
-			reasoning: z.enum([
-				"provider-default",
-				"none",
-				"minimal",
-				"low",
-				"medium",
-				"high",
-				"xhigh"
-			]).optional().catch(void 0),
-			source: source.optional(),
-			routing: modelRouting.optional(),
-			endpoint: modelEndpoint.optional()
-		}),
+		model: agentModel,
 		name: z.string(),
 		outputSchema: z.unknown().optional()
 	}),
@@ -503,19 +514,28 @@ async function* readNdjsonStream(body) {
 //#endregion
 //#region src/client/url.ts
 function createClientUrl(host, routePath, searchParams) {
-	const normalizedRoute = routePath.startsWith("/") ? routePath : `/${routePath}`;
+	const queryIndex = routePath.indexOf("?");
+	const pathOnly = queryIndex === -1 ? routePath : routePath.slice(0, queryIndex);
+	const embeddedQuery = queryIndex === -1 ? "" : routePath.slice(queryIndex + 1);
+	const normalizedRoute = pathOnly.startsWith("/") ? pathOnly : `/${pathOnly}`;
 	if (isAbsoluteUrl(host)) {
 		const url = new URL(host);
 		url.pathname = `${trimTrailingSlash(url.pathname)}${normalizedRoute}`;
+		mergeEmbeddedQuery(url.searchParams, embeddedQuery);
 		mergeSearchParams(url.searchParams, searchParams);
 		url.hash = "";
 		return url.toString();
 	}
 	const url = new URL(host, "http://eve.local");
 	const basePath = trimTrailingSlash(url.pathname);
+	mergeEmbeddedQuery(url.searchParams, embeddedQuery);
 	mergeSearchParams(url.searchParams, searchParams);
 	return `${basePath}${normalizedRoute}${formatSearch(url.searchParams)}`;
 }
+function mergeEmbeddedQuery(target, embeddedQuery) {
+	if (embeddedQuery.length === 0) return;
+	for (const [name, value] of new URLSearchParams(embeddedQuery)) target.append(name, value);
+}
 function isAbsoluteUrl(value) {
 	return /^[a-z][a-z\d+\-.]*:/i.test(value);
 }
@@ -888,11 +908,25 @@ function serializeSchema(source, direction) {
 	return toJsonObject(source, direction);
 }
 function toJsonObject(source, direction) {
-	const { $schema: _schemaVersion, ...canonical } = isStandardJsonSchema(source) ? parseJsonObject(source["~standard"].jsonSchema[direction]({ target: JSON_SCHEMA_TARGET })) : parseJsonObject(source);
+	const standard = getStandardSchemaProperties(source);
+	const jsonSchema = standard?.jsonSchema;
+	const emit = typeof jsonSchema === "object" && jsonSchema !== null ? jsonSchema[direction] : void 0;
+	const vendor = typeof standard?.vendor === "string" ? standard.vendor : "unknown";
+	if (standard !== void 0 && typeof emit !== "function" && vendor === "zod") {
+		if (direction === "input") {
+			const { $schema: _schemaVersion, ...canonical } = parseJsonObject(asSchema(source).jsonSchema);
+			return canonical;
+		}
+		throw new Error("Zod 3 cannot emit an output JSON Schema. Upgrade to Zod 4 or provide a plain JSON Schema object.");
+	}
+	if (standard !== void 0 && typeof emit !== "function") throw new Error(`Standard Schema vendor "${vendor}" does not support JSON Schema conversion. Provide a Standard Schema implementation with JSON Schema conversion or a plain JSON Schema object.`);
+	const { $schema: _schemaVersion, ...canonical } = standard === void 0 ? parseJsonObject(source) : parseJsonObject(emit({ target: JSON_SCHEMA_TARGET }));
 	return canonical;
 }
-function isStandardJsonSchema(value) {
-	return value !== null && typeof value === "object" && "~standard" in value;
+function getStandardSchemaProperties(value) {
+	if (typeof value !== "object" || value === null || !("~standard" in value)) return void 0;
+	const standard = value["~standard"];
+	return typeof standard === "object" && standard !== null ? standard : void 0;
 }
 
 //#endregion
@@ -1073,6 +1107,7 @@ function createMessageBody(input, requireMessage) {
 	const body = {};
 	if (input.message !== void 0) body.message = input.message;
 	if (input.inputResponses !== void 0 && input.inputResponses.length > 0) body.inputResponses = input.inputResponses;
+	if (!requireMessage && input.message !== void 0 && input.turnPolicy !== void 0) body.turnPolicy = input.turnPolicy;
 	if (input.clientContext !== void 0) body.clientContext = input.clientContext;
 	const outputSchema = serializeOutputSchema(input.outputSchema);
 	if (outputSchema !== void 0) body.outputSchema = outputSchema;

package/dist/src/cli/commands/agent-prompt/collect-intent.md

@@ -16,3 +16,6 @@ the coding harness's prompt tools when available, and do not guess.
    under `agent/connections/`. When a system needs every end-user to sign in, wire
    its auth through **Vercel Connect** (`connect()` from `@vercel/connect/eve`),
    which handles consent, encrypted token storage, and refresh.
+4. Does the user want a specific AI Gateway model or reasoning effort? If so,
+   pass its `provider/model-id` to `eve init --model` and its reasoning effort to
+   `--reasoning`; otherwise, use eve's defaults.

package/dist/src/cli/commands/agent-prompt/scaffold.md

@@ -4,7 +4,7 @@ First settle the target: a new project, or the agent added to an existing
 directory? For a new project, propose a name and ask the user to confirm it; for
 an existing one, ask for the directory.
 
-For a new project, run (append `--channel-web-nextjs` only if the user wants Web
+For a new project, run (`--channel-web-nextjs` is only for users who want Web
 Chat):
 
     npx eve@latest init <name>
@@ -18,5 +18,7 @@ If the user wants a reusable extension package instead of an agent, run
 
 For an existing app, run `npx eve@latest init .` from its directory. This adds the
 agent and missing dependencies while leaving the existing Git repository and app
-scripts alone. If init cannot be used, install by hand with
+scripts alone. Append `--model provider/model-id` or `--reasoning effort` to
+either init command when the user chose those settings. If init cannot be used,
+install by hand with
 `npm install eve@latest ai zod`; manual installation does not add package scripts.

package/dist/src/cli/commands/info.js

@@ -1,2 +1,2 @@
-import{createCliTheme,renderCliBanner,renderCliSection}from"#cli/ui/output.js";import{inspectApplication}from"#services/inspect-application.js";function buildApplicationInfoJson(e){let{application:t,compiledState:n,messaging:r}=e;return{appRoot:t.appRoot,agentRoot:n?.project.agentRoot??null,layout:n?.project.layout??null,status:n?.metadata.status??`unavailable`,diagnostics:n?{errors:n.metadata.discovery.summary.errors,warnings:n.metadata.discovery.summary.warnings}:null,model:n?.manifest.config.model.id??null,instructions:n?.manifest.instructions?.logicalPath??null,skills:(n?.manifest.skills??[]).map(e=>e.name),tools:(n?.manifest.tools??[]).map(e=>e.name),subagents:(n?.manifest.subagents??[]).map(e=>e.name),schedules:(n?.manifest.schedules??[]).map(e=>e.name),channels:(n?.manifest.channels??[]).map(e=>e.kind===`channel`?{name:e.name,kind:e.adapterKind??null,method:e.method,urlPath:e.urlPath}:{name:e.name,kind:`disabled`,method:null,urlPath:null}),messaging:{create:r.createSessionRoutePath,messages:r.sessionMessagesRoutePattern,stream:r.streamRoutePattern},artifacts:n?{compiledManifest:n.paths.compiledManifestPath,discoveryManifest:n.paths.discoveryManifestPath,diagnostics:n.paths.diagnosticsPath,moduleMap:n.paths.moduleMapPath,metadata:n.paths.compileMetadataPath}:null}}function pluralize(e,t){return`${e} ${t}${e===1?``:`s`}`}function formatDiscoverySummary(e,t){return`${pluralize(e,`error`)}, ${pluralize(t,`warning`)}`}function resolveCompileTone(e){switch(e){case`ready`:return`success`;case`failed`:return`danger`;default:return`warning`}}async function printApplicationInfo(i,a,o={}){let s=await inspectApplication(a);if(o.json){i.log(JSON.stringify(buildApplicationInfoJson(s),null,2));return}let c=s.compiledState,l=s.application,u=createCliTheme(),d=[{label:`App Root`,value:l.appRoot}],f=[{label:`Workflow Build`,value:l.workflowBuildDir},{label:`Output`,value:l.outputDir}],p=[];c===null?d.push({label:`Compile`,tone:`warning`,value:`unavailable`}):(d.push({label:`Agent Root`,value:c.project.agentRoot},{label:`Layout`,value:c.project.layout},{label:`Compile`,tone:resolveCompileTone(c.metadata.status),value:c.metadata.status},{label:`Diagnostics`,tone:c.metadata.discovery.summary.errors>0?`danger`:c.metadata.discovery.summary.warnings>0?`warning`:`success`,value:formatDiscoverySummary(c.metadata.discovery.summary.errors,c.metadata.discovery.summary.warnings)},{label:`Instructions`,value:c.manifest.instructions?.logicalPath??`none`},{label:`Skills`,value:pluralize(c.manifest.skills.length,`skill`)},{label:`Tools`,value:pluralize(c.manifest.tools.length,`tool`)},{label:`Subagents`,value:pluralize(c.manifest.subagents.length,`subagent`)},{label:`Schedules`,value:pluralize(c.manifest.schedules.length,`schedule`)}),f.unshift({label:`Compiled Manifest`,value:c.paths.compiledManifestPath},{label:`Discovery Manifest`,value:c.paths.discoveryManifestPath},{label:`Diagnostics`,value:c.paths.diagnosticsPath},{label:`Module Map`,value:c.paths.moduleMapPath},{label:`Metadata`,value:c.paths.compileMetadataPath}),p.push(c.manifest.instructions===void 0?{label:`Instructions`,value:`No instructions prompt discovered.`}:{label:`Instructions`,value:c.manifest.instructions.logicalPath})),i.log([renderCliBanner(u,{subtitle:`Resolved application paths and the active message contract.`,title:`eve Info`}),``,renderCliSection(u,{rows:d,title:`Application`}),``,renderCliSection(u,{rows:f,title:`Artifacts`}),...c===null?[]:[``,renderCliSection(u,{rows:p,title:`Instructions`})],``,renderCliSection(u,{rows:[{label:`Workflow ID`,value:l.workflowId},{label:`Source Dir`,value:l.workflowSourceDir},{label:`Create`,tone:`info`,value:`POST ${s.messaging.createSessionRoutePath}`},{label:`Messages`,tone:`info`,value:`POST ${s.messaging.sessionMessagesRoutePattern}`},{label:`Stream`,tone:`info`,value:`GET ${s.messaging.streamRoutePattern}`}],title:`Messaging`})].join(`
+import{createCliTheme,renderCliBanner,renderCliSection}from"#cli/ui/output.js";import{inspectApplication}from"#services/inspect-application.js";function buildApplicationInfoJson(e){let{application:t,compiledState:n,messaging:r}=e;return{appRoot:t.appRoot,agentRoot:n?.project.agentRoot??null,layout:n?.project.layout??null,status:n?.metadata.status??`unavailable`,diagnostics:n?{errors:n.metadata.discovery.summary.errors,warnings:n.metadata.discovery.summary.warnings}:null,model:n?.manifest.config.model?.id??null,instructions:n?.manifest.instructions?.logicalPath??null,skills:(n?.manifest.skills??[]).map(e=>e.name),tools:(n?.manifest.tools??[]).map(e=>e.name),subagents:(n?.manifest.subagents??[]).map(e=>e.name),schedules:(n?.manifest.schedules??[]).map(e=>e.name),channels:(n?.manifest.channels??[]).map(e=>e.kind===`channel`?{name:e.name,kind:e.adapterKind??null,method:e.method,urlPath:e.urlPath}:{name:e.name,kind:`disabled`,method:null,urlPath:null}),messaging:{create:r.createSessionRoutePath,messages:r.sessionMessagesRoutePattern,stream:r.streamRoutePattern},artifacts:n?{compiledManifest:n.paths.compiledManifestPath,discoveryManifest:n.paths.discoveryManifestPath,diagnostics:n.paths.diagnosticsPath,moduleMap:n.paths.moduleMapPath,metadata:n.paths.compileMetadataPath}:null}}function pluralize(e,t){return`${e} ${t}${e===1?``:`s`}`}function formatDiscoverySummary(e,t){return`${pluralize(e,`error`)}, ${pluralize(t,`warning`)}`}function resolveCompileTone(e){switch(e){case`ready`:return`success`;case`failed`:return`danger`;default:return`warning`}}async function printApplicationInfo(i,a,o={}){let s=await inspectApplication(a);if(o.json){i.log(JSON.stringify(buildApplicationInfoJson(s),null,2));return}let c=s.compiledState,l=s.application,u=createCliTheme(),d=[{label:`App Root`,value:l.appRoot}],f=[{label:`Workflow Build`,value:l.workflowBuildDir},{label:`Output`,value:l.outputDir}],p=[];c===null?d.push({label:`Compile`,tone:`warning`,value:`unavailable`}):(d.push({label:`Agent Root`,value:c.project.agentRoot},{label:`Layout`,value:c.project.layout},{label:`Compile`,tone:resolveCompileTone(c.metadata.status),value:c.metadata.status},{label:`Diagnostics`,tone:c.metadata.discovery.summary.errors>0?`danger`:c.metadata.discovery.summary.warnings>0?`warning`:`success`,value:formatDiscoverySummary(c.metadata.discovery.summary.errors,c.metadata.discovery.summary.warnings)},{label:`Instructions`,value:c.manifest.instructions?.logicalPath??`none`},{label:`Skills`,value:pluralize(c.manifest.skills.length,`skill`)},{label:`Tools`,value:pluralize(c.manifest.tools.length,`tool`)},{label:`Subagents`,value:pluralize(c.manifest.subagents.length,`subagent`)},{label:`Schedules`,value:pluralize(c.manifest.schedules.length,`schedule`)}),f.unshift({label:`Compiled Manifest`,value:c.paths.compiledManifestPath},{label:`Discovery Manifest`,value:c.paths.discoveryManifestPath},{label:`Diagnostics`,value:c.paths.diagnosticsPath},{label:`Module Map`,value:c.paths.moduleMapPath},{label:`Metadata`,value:c.paths.compileMetadataPath}),p.push(c.manifest.instructions===void 0?{label:`Instructions`,value:`No instructions prompt discovered.`}:{label:`Instructions`,value:c.manifest.instructions.logicalPath})),i.log([renderCliBanner(u,{subtitle:`Resolved application paths and the active message contract.`,title:`eve Info`}),``,renderCliSection(u,{rows:d,title:`Application`}),``,renderCliSection(u,{rows:f,title:`Artifacts`}),...c===null?[]:[``,renderCliSection(u,{rows:p,title:`Instructions`})],``,renderCliSection(u,{rows:[{label:`Workflow ID`,value:l.workflowId},{label:`Source Dir`,value:l.workflowSourceDir},{label:`Create`,tone:`info`,value:`POST ${s.messaging.createSessionRoutePath}`},{label:`Messages`,tone:`info`,value:`POST ${s.messaging.sessionMessagesRoutePattern}`},{label:`Stream`,tone:`info`,value:`GET ${s.messaging.streamRoutePattern}`}],title:`Messaging`})].join(`
 `))}export{buildApplicationInfoJson,printApplicationInfo};