eve 0.21.1 → 0.22.0

package/dist/src/public/definitions/channel.d.ts

@@ -1,6 +1,18 @@
+import { CHANNEL_SENTINEL } from "#channel/compiled-channel.js";
+import { type ChannelCorsOptions } from "#channel/cors.js";
+import type { TypedReceiveTarget } from "#channel/receive-target.js";
+import type { RouteDefinition, SendFn } from "#channel/routes.js";
+import type { Session } from "#channel/session.js";
 import type { DeliverInput, GetEventStreamOptions, RunHandle, RunInput } from "#channel/types.js";
 import type { HandleMessageStreamEvent } from "#protocol/message.js";
+import type { SessionContext } from "#public/definitions/callback-context.js";
+import type { GenericChannelDefinition, GenericReceiveInput } from "#shared/channel-definition.js";
+declare const CHANNEL_METADATA_TYPE: unique symbol;
 export type { GetEventStreamOptions } from "#channel/types.js";
+export type { Session, SessionHandle } from "#channel/session.js";
+export type { ChannelCors, ChannelCorsOptions } from "#channel/cors.js";
+export { GET, POST, PUT, PATCH, DELETE, WS } from "#channel/routes.js";
+export type { HttpRouteDefinition, RouteDefinition, RouteHandlerArgs, SendFn, SendOptions, SendPayload, GetSessionFn, WebSocketMessage, WebSocketPeer, WebSocketRouteDefinition, WebSocketRouteHandler, WebSocketRouteHooks, WebSocketUpgradeRequest, WebSocketUpgradeResult, } from "#channel/routes.js";
 /**
  * HTTP method a route handles. Defaults to `"POST"` — almost every route
  * is a webhook. Override only when authoring a non-webhook route such as a
@@ -124,3 +136,90 @@ export declare function disableRoute(): DisabledRouteSentinel;
  * produced by {@link disableRoute}.
  */
 export declare function isDisabledRouteSentinel(value: unknown): value is DisabledRouteSentinel;
+type EventData<T extends HandleMessageStreamEvent["type"]> = Extract<HandleMessageStreamEvent, {
+    type: T;
+}> extends {
+    data: infer D;
+} ? D : undefined;
+/**
+ * Session operations on the `channel` argument of every channel event handler.
+ */
+export interface ChannelSessionOps {
+    readonly continuationToken: string;
+    setContinuationToken(token: string): void;
+}
+/**
+ * Channel context passed to event handlers: `TCtx` intersected with
+ * {@link ChannelSessionOps}.
+ */
+export type ChannelContext<TCtx> = TCtx & ChannelSessionOps;
+type ChannelEventHandler<T extends HandleMessageStreamEvent["type"], TCtx> = (data: EventData<T>, channel: ChannelContext<TCtx>, ctx: SessionContext) => void | Promise<void>;
+type ChannelSessionFailedHandler<TCtx> = (data: EventData<"session.failed">, channel: ChannelContext<TCtx>) => void | Promise<void>;
+/**
+ * Optional handlers keyed by session lifecycle event name. Each handler receives
+ * the event `data`, the {@link ChannelContext}, and a {@link SessionContext}
+ * `ctx`. The `session.failed` handler is the exception: it receives only `data`
+ * and the channel context, with no `ctx`.
+ */
+export interface ChannelEvents<TCtx = void> {
+    readonly "turn.started"?: ChannelEventHandler<"turn.started", TCtx>;
+    readonly "actions.requested"?: ChannelEventHandler<"actions.requested", TCtx>;
+    readonly "action.result"?: ChannelEventHandler<"action.result", TCtx>;
+    readonly "message.completed"?: ChannelEventHandler<"message.completed", TCtx>;
+    readonly "message.appended"?: ChannelEventHandler<"message.appended", TCtx>;
+    readonly "reasoning.appended"?: ChannelEventHandler<"reasoning.appended", TCtx>;
+    readonly "reasoning.completed"?: ChannelEventHandler<"reasoning.completed", TCtx>;
+    readonly "input.requested"?: ChannelEventHandler<"input.requested", TCtx>;
+    readonly "turn.failed"?: ChannelEventHandler<"turn.failed", TCtx>;
+    readonly "turn.completed"?: ChannelEventHandler<"turn.completed", TCtx>;
+    readonly "session.failed"?: ChannelSessionFailedHandler<TCtx>;
+    readonly "session.completed"?: ChannelEventHandler<"session.completed", TCtx>;
+    readonly "session.waiting"?: ChannelEventHandler<"session.waiting", TCtx>;
+    readonly "authorization.required"?: ChannelEventHandler<"authorization.required", TCtx>;
+    readonly "authorization.completed"?: ChannelEventHandler<"authorization.completed", TCtx>;
+}
+/**
+ * Input passed to a channel's `receive` callback when another channel or
+ * schedule proactively routes a message to it.
+ */
+export type ReceiveInput<TReceiveTarget = Record<string, unknown>> = GenericReceiveInput<TReceiveTarget>;
+/**
+ * The object passed to {@link defineChannel}. `routes` is required; `state`
+ * seeds durable adapter state, `context` builds the per-step `channel` argument
+ * for `events` and `deliver`, `events` handle session lifecycle, `receive`
+ * accepts cross-channel handoffs, `fetchFile` stages remote file URLs, and
+ * `metadata` projects observability data.
+ *
+ * Generics: `TState` (adapter state), `TCtx` (context factory return type),
+ * `TReceiveTarget` (cross-channel target shape), `TMetadata` (instrumentation
+ * projection).
+ */
+export type ChannelDefinition<TState = undefined, TCtx = void, TReceiveTarget = Record<string, unknown>, TMetadata extends Record<string, unknown> = Record<string, unknown>> = GenericChannelDefinition<ChannelEvents<TCtx>, TState, TCtx, TReceiveTarget, TMetadata>;
+/**
+ * Opaque channel value produced by {@link defineChannel} and exported from
+ * `agent/channels/<name>.ts`. Exposes the channel's routes, an optional
+ * `receive` hook, and (via a phantom property) its metadata shape. Unlike
+ * {@link ChannelDefinition} it has no `TCtx` parameter: the context type is
+ * internal to the definition.
+ */
+export interface Channel<TState = undefined, TReceiveTarget = Record<string, unknown>, TMetadata extends Record<string, unknown> = Record<string, unknown>> extends TypedReceiveTarget<TReceiveTarget> {
+    readonly __kind: typeof CHANNEL_SENTINEL;
+    readonly [CHANNEL_METADATA_TYPE]?: TMetadata;
+    readonly routes: readonly RouteDefinition<TState>[];
+    readonly cors?: ChannelCorsOptions;
+    readonly receive?: (input: ReceiveInput<TReceiveTarget>, args: {
+        send: SendFn<TState>;
+    }) => Promise<Session>;
+}
+/**
+ * Extracts the metadata projection type (`TMetadata`) from a {@link Channel}.
+ * Resolves to `Record<string, unknown>` when the value is not a Channel.
+ */
+export type InferChannelMetadata<TChannel> = TChannel extends Channel<any, any, infer TMetadata> ? TMetadata : Record<string, unknown>;
+/**
+ * Builds a {@link Channel} from a {@link ChannelDefinition}. Returns a value
+ * placed at `agent/channels/<name>.ts`; the file path supplies the channel name
+ * (do not add a `name` field). `TCtx` (the context factory's return type) is
+ * internal to the definition and is not part of the returned Channel signature.
+ */
+export declare function defineChannel<TState = undefined, TCtx = void, TReceiveTarget = Record<string, unknown>, TMetadata extends Record<string, unknown> = Record<string, unknown>>(definition: ChannelDefinition<TState, TCtx, TReceiveTarget, TMetadata>): Channel<TState, TReceiveTarget, TMetadata>;

package/dist/src/public/definitions/channel.js

@@ -1 +1 @@
-const DISABLED_ROUTE_SENTINEL_KIND=`eve:disabled-channel`;function disableRoute(){return{kind:DISABLED_ROUTE_SENTINEL_KIND}}function isDisabledRouteSentinel(e){return typeof e==`object`&&!!e&&e.kind===DISABLED_ROUTE_SENTINEL_KIND}export{disableRoute,isDisabledRouteSentinel};
+import{CHANNEL_SENTINEL}from"#channel/compiled-channel.js";import{defaultDeliverResult}from"#channel/adapter.js";import{buildCallbackContext}from"#context/build-callback-context.js";import{normalizeChannelCors}from"#channel/cors.js";import{HTTP_ADAPTER_KIND}from"#channel/http.js";import{DELETE,GET,PATCH,POST,PUT,WS}from"#channel/routes.js";const DISABLED_ROUTE_SENTINEL_KIND=`eve:disabled-channel`;function disableRoute(){return{kind:DISABLED_ROUTE_SENTINEL_KIND}}function isDisabledRouteSentinel(e){return typeof e==`object`&&!!e&&e.kind===DISABLED_ROUTE_SENTINEL_KIND}function defineChannel(t){let n=buildAdapter(t),i=normalizeChannelCors(t.cors);return{__kind:CHANNEL_SENTINEL,routes:t.routes,adapter:n,cors:i,receive:t.receive}}function buildAdapter(e){let r=e.state!=null,a=e.context!=null,o=e.fetchFile!==void 0,s=e.metadata,c=r||a||s!==void 0,l={},u=!1,d=[`turn.started`,`actions.requested`,`action.result`,`message.completed`,`message.appended`,`reasoning.appended`,`reasoning.completed`,`input.requested`,`turn.failed`,`turn.completed`,`session.failed`,`session.completed`,`session.waiting`,`authorization.required`,`authorization.completed`],f=e.events;for(let e of d){let t=f?.[e];t&&(u=!0,l[e]=(r,i)=>{let a={...i,continuationToken:i.session?.continuationToken??``,setContinuationToken:e=>i.session?.setContinuationToken(e)};return e===`session.failed`?t(r,a):t(r,a,buildCallbackContext())})}return!c&&!u&&!o?{kind:e.kindHint??HTTP_ADAPTER_KIND}:{kind:e.kindHint??`defineChannel`,state:r?{...e.state}:{},fetchFile:e.fetchFile,instrumentation:s===void 0?void 0:{metadata(e){return s(e)}},createAdapterContext(t){let n=t.state,r=t.session;return{...a?e.context(n,r):{},state:n,ctx:t.ctx,session:r}},deliver(e){return defaultDeliverResult(e)},...l}}export{DELETE,GET,PATCH,POST,PUT,WS,defineChannel,disableRoute,isDisabledRouteSentinel};

package/dist/src/public/definitions/hook.d.ts

@@ -1,6 +1,7 @@
 import type { HandleMessageStreamEvent } from "../../protocol/message.js";
 import type { SessionContext } from "./callback-context.js";
 import type { ExactDefinition } from "./exact.js";
+import type { GenericHookDefinition, GenericStreamEventHooks } from "#shared/hook-definition.js";
 /**
  * Every hook handler receives this context.
  *
@@ -31,13 +32,7 @@ export type StreamEventHook<TEvent> = (event: TEvent, ctx: HookContext) => void
  * `*` matches every accepted runtime stream event and runs after the
  * typed handler for that event (if any).
  */
-export type StreamEventHooks = {
-    readonly "*"?: StreamEventHook<HandleMessageStreamEvent>;
-} & {
-    readonly [K in HandleMessageStreamEvent["type"]]?: StreamEventHook<Extract<HandleMessageStreamEvent, {
-        type: K;
-    }>>;
-};
+export type StreamEventHooks = GenericStreamEventHooks<HandleMessageStreamEvent, HookContext>;
 /**
  * Public hook definition authored in `agent/hooks/*.ts`.
  *
@@ -47,9 +42,7 @@ export type StreamEventHooks = {
  * contribute runtime model messages, use `defineDynamic` +
  * `defineInstructions` in `agent/instructions/`.
  */
-export interface HookDefinition {
-    readonly events?: StreamEventHooks;
-}
+export type HookDefinition = GenericHookDefinition<HandleMessageStreamEvent, HookContext>;
 /**
  * Identity-with-types helper. Returns the passed definition unchanged
  * (identity at runtime) while preserving literal inference and rejecting

package/dist/src/public/definitions/instructions.d.ts

@@ -1,22 +1,6 @@
 import type { ExactDefinition } from "#public/definitions/exact.js";
-/**
- * Public definition for an instructions prompt authored in markdown or
- * TypeScript.
- *
- * Authored at the agent root as either `instructions.md` or
- * `instructions.{ts,cts,mts,js,cjs,mjs}`, or inside the
- * `agent/instructions/` directory for multi-file setups. Module-backed
- * static instructions execute once at build time. The compiler captures
- * the resulting markdown into the compiled manifest.
- *
- * When used inside a `defineDynamic` handler, the runtime lowers the
- * returned markdown to `{ role: "system", content: markdown }`.
- * Instructions produce system messages only. Use channel `context` for
- * user-role messages.
- */
-export interface InstructionsDefinition {
-    readonly markdown: string;
-}
+import type { PublicInstructionsDefinition } from "#shared/instructions-definition.js";
+export type InstructionsDefinition = Readonly<PublicInstructionsDefinition>;
 /**
  * Defines an instructions prompt in TypeScript from a `{ markdown }`
  * definition.

package/dist/src/public/definitions/schedule.d.ts

@@ -1,6 +1,7 @@
 import type { CrossChannelReceiveFn } from "#channel/cross-channel-receive.js";
 import type { SessionAuthContext } from "#channel/types.js";
 import type { ExactDefinition } from "#public/definitions/exact.js";
+import type { GenericScheduleDefinition, GenericScheduleRunHandler, GenericScheduleDefinitionFields } from "#shared/schedule-definition.js";
 export type { InferReceiveTarget, TypedReceiveTarget } from "#channel/receive-target.js";
 /**
  * Arguments passed to a schedule's `run` handler. A tight subset of a route
@@ -31,13 +32,7 @@ export interface ScheduleHandlerArgs {
  * schedule's cron fires. It receives {@link ScheduleHandlerArgs} (`receive`,
  * `waitUntil`, `appAuth`) and may return synchronously or as a promise.
  */
-export type ScheduleRunHandler = (args: ScheduleHandlerArgs) => Promise<void> | void;
-/** Constraint shape that bounds the authored keys accepted by {@link defineSchedule}. */
-interface ScheduleDefinitionFields {
-    readonly cron: string;
-    readonly markdown?: string;
-    readonly run?: ScheduleRunHandler;
-}
+export type ScheduleRunHandler = GenericScheduleRunHandler<ScheduleHandlerArgs>;
 /**
  * Public definition for a schedule authored in TypeScript. Provide a required
  * `cron` expression plus exactly one of `markdown` or `run`:
@@ -51,15 +46,7 @@ interface ScheduleDefinitionFields {
  * Identity is derived from the file path under `agent/schedules/`; authored
  * definitions do not carry a `name` field.
  */
-export type ScheduleDefinition = {
-    readonly cron: string;
-    readonly markdown: string;
-    readonly run?: never;
-} | {
-    readonly cron: string;
-    readonly markdown?: never;
-    readonly run: ScheduleRunHandler;
-};
+export type ScheduleDefinition = GenericScheduleDefinition<ScheduleHandlerArgs>;
 /**
  * Defines a schedule in TypeScript. Export as the default from
  * `agent/schedules/<name>.ts`. Pass a `cron` expression plus exactly one of
@@ -93,4 +80,4 @@ export type ScheduleDefinition = {
  * });
  * ```
  */
-export declare function defineSchedule<TSchedule extends ScheduleDefinition>(definition: ExactDefinition<TSchedule, ScheduleDefinitionFields>): TSchedule;
+export declare function defineSchedule<TSchedule extends ScheduleDefinition>(definition: ExactDefinition<TSchedule, GenericScheduleDefinitionFields<ScheduleHandlerArgs>>): TSchedule;

package/dist/src/public/definitions/tool.d.ts

@@ -4,8 +4,10 @@ import type { SessionContext } from "#public/definitions/callback-context.js";
 import type { Approval } from "#public/definitions/approval.js";
 import type { JsonObject } from "#shared/json.js";
 import type { AuthorizationDefinition, ConnectionAuthorizationContext, NonInteractiveAuthorizationDefinition, TokenResult } from "#runtime/connections/types.js";
-import { type DynamicEvents, type DynamicSentinel } from "#shared/dynamic-tool-definition.js";
+import { type DynamicEvents, type DynamicEventsWithFallback, type DynamicSentinel } from "#shared/dynamic-tool-definition.js";
 type ApprovalContextInput<TInput> = unknown extends TInput ? Record<string, unknown> : TInput;
+type DynamicEventMapHandler<TEvents extends DynamicEvents> = Extract<NonNullable<TEvents[keyof TEvents]>, (...args: never[]) => unknown>;
+type DynamicEventMapResult<TEvents extends DynamicEvents> = Awaited<ReturnType<DynamicEventMapHandler<TEvents>>>;
 export type { ToolModelOutput } from "#shared/tool-definition.js";
 /**
  * Authorization provider passed to {@link ToolContext.getToken} or
@@ -191,9 +193,13 @@ export declare function defineTool<TInput = unknown, TOutput = unknown>(definiti
  * whose name matches an authored one overrides it; two dynamic resolvers
  * emitting the same name is an error.
  */
-export declare function defineDynamic(definition: {
-    readonly events: DynamicEvents;
-}): DynamicSentinel;
+export declare function defineDynamic<const TEvents extends DynamicEvents>(definition: {
+    readonly events: TEvents;
+}): DynamicSentinel<DynamicEventMapResult<TEvents>>;
+export declare function defineDynamic<const TEvents extends DynamicEventsWithFallback, TFallback = unknown>(definition: {
+    readonly fallback: TFallback;
+    readonly events: TEvents;
+}): DynamicSentinel<Exclude<DynamicEventMapResult<TEvents>, undefined>, TFallback>;
 /**
  * Marker discriminator written into every {@link DisabledToolSentinel}.
  */

package/dist/src/public/definitions/tool.js

@@ -1 +1 @@
-import{DYNAMIC_SENTINEL_KIND,TOOL_BRAND}from"#shared/dynamic-tool-definition.js";import{stampDefinitionKey}from"#public/tool-result-narrowing.js";function defineTool(e){if(e.auth!==void 0)throw Error(`defineTool: The "auth" field is no longer supported. Pass auth providers inline to ctx.getToken(provider) or ctx.requireAuth(provider).`);return Object.assign(e,{[TOOL_BRAND]:!0}),stampDefinitionKey(e,`tool:${e.description}`),e}function defineDynamic(t){let n={kind:DYNAMIC_SENTINEL_KIND,events:t.events};return stampDefinitionKey(n,`dynamic:${Object.keys(t.events).join(`,`)}`),n}const DISABLED_TOOL_SENTINEL_KIND=`eve:disabled-tool`;function disableTool(){return{kind:DISABLED_TOOL_SENTINEL_KIND}}function isDisabledToolSentinel(e){return typeof e==`object`&&!!e&&e.kind===DISABLED_TOOL_SENTINEL_KIND}const ENABLE_WORKFLOW_TOOL_SENTINEL_KIND=`eve:enable-workflow-tool`,ExperimentalWorkflow=Object.freeze({kind:ENABLE_WORKFLOW_TOOL_SENTINEL_KIND});function isEnableWorkflowToolSentinel(e){return typeof e==`object`&&!!e&&e.kind===ENABLE_WORKFLOW_TOOL_SENTINEL_KIND}export{ExperimentalWorkflow,defineDynamic,defineTool,disableTool,isDisabledToolSentinel,isEnableWorkflowToolSentinel};
+import{DYNAMIC_SENTINEL_KIND,TOOL_BRAND}from"#shared/dynamic-tool-definition.js";import{stampDefinitionKey}from"#public/tool-result-narrowing.js";function defineTool(e){if(e.auth!==void 0)throw Error(`defineTool: The "auth" field is no longer supported. Pass auth providers inline to ctx.getToken(provider) or ctx.requireAuth(provider).`);return Object.assign(e,{[TOOL_BRAND]:!0}),stampDefinitionKey(e,`tool:${e.description}`),e}function defineDynamic(t){let n={kind:DYNAMIC_SENTINEL_KIND,events:t.events,...Object.hasOwn(t,`fallback`)?{fallback:t.fallback}:{}};return stampDefinitionKey(n,`dynamic:${Object.keys(t.events).join(`,`)}`),n}const DISABLED_TOOL_SENTINEL_KIND=`eve:disabled-tool`;function disableTool(){return{kind:DISABLED_TOOL_SENTINEL_KIND}}function isDisabledToolSentinel(e){return typeof e==`object`&&!!e&&e.kind===DISABLED_TOOL_SENTINEL_KIND}const ENABLE_WORKFLOW_TOOL_SENTINEL_KIND=`eve:enable-workflow-tool`,ExperimentalWorkflow=Object.freeze({kind:ENABLE_WORKFLOW_TOOL_SENTINEL_KIND});function isEnableWorkflowToolSentinel(e){return typeof e==`object`&&!!e&&e.kind===ENABLE_WORKFLOW_TOOL_SENTINEL_KIND}export{ExperimentalWorkflow,defineDynamic,defineTool,disableTool,isDisabledToolSentinel,isEnableWorkflowToolSentinel};

package/dist/src/public/hooks/index.d.ts

@@ -5,4 +5,4 @@
  * See {@link defineHook} for the authoring shape and
  * {@link HookContext} for the runtime context every handler receives.
  */
-export { type HookContext, type HookDefinition, type StreamEventHook, type StreamEventHooks, defineHook, } from "../definitions/hook.js";
+export { type HookContext, type HookDefinition, type StreamEventHook, type StreamEventHooks, defineHook, } from "#public/definitions/hook.js";

package/dist/src/public/hooks/index.js

@@ -1 +1 @@
-import{defineHook}from"../definitions/hook.js";export{defineHook};
+import{defineHook}from"#public/definitions/hook.js";export{defineHook};

package/dist/src/public/index.d.ts

@@ -2,4 +2,6 @@
  * Core agent authoring helpers for `agent/agent.ts`.
  */
 export { type AgentCompactionDefinition, type AgentDefinition, type AgentExperimentalDefinition, type AgentLimitsDefinition, type AgentModelDefinition, type AgentModelOptionsDefinition, type AgentReasoningDefinition, type AgentWorkflowDefinition, type AgentWorkflowWorldDefinition, defineAgent, } from "#public/definitions/agent.js";
+export { defineDynamic } from "#public/definitions/tool.js";
+export type { DynamicResolveContext, DynamicSentinel } from "#shared/dynamic-tool-definition.js";
 export { type RemoteAgentDefinition, type RemoteAgentDefinitionInput, defineRemoteAgent, } from "#public/definitions/remote-agent.js";

package/dist/src/public/index.js

@@ -1 +1 @@
-import{defineAgent}from"#public/definitions/agent.js";import{defineRemoteAgent}from"#public/definitions/remote-agent.js";export{defineAgent,defineRemoteAgent};
+import{defineDynamic}from"#public/definitions/tool.js";import{defineAgent}from"#public/definitions/agent.js";import{defineRemoteAgent}from"#public/definitions/remote-agent.js";export{defineAgent,defineDynamic,defineRemoteAgent};

package/dist/src/public/sandbox/backends/default.d.ts

@@ -1,7 +1,7 @@
 import type { SandboxBackend } from "#public/definitions/sandbox-backend.js";
 import type { DockerSandboxCreateOptions } from "#public/sandbox/docker-sandbox.js";
 import type { JustBashSandboxCreateOptions } from "#public/sandbox/just-bash-sandbox.js";
-import type { MicrosandboxCreateOptions } from "#public/sandbox/microsandbox-sandbox.js";
+import type { MicrosandboxSandboxCreateOptions } from "#public/sandbox/microsandbox-sandbox.js";
 import type { VercelSandboxCreateOptions } from "#public/sandbox/vercel-sandbox.js";
 /**
  * Input to {@link defaultSandbox}: a separate options bag per inner
@@ -11,7 +11,7 @@ import type { VercelSandboxCreateOptions } from "#public/sandbox/vercel-sandbox.
 export interface DefaultSandboxOptions {
     readonly docker?: DockerSandboxCreateOptions;
     readonly justBash?: JustBashSandboxCreateOptions;
-    readonly microsandbox?: MicrosandboxCreateOptions;
+    readonly microsandbox?: MicrosandboxSandboxCreateOptions;
     readonly vercel?: VercelSandboxCreateOptions;
 }
 /**

package/dist/src/public/sandbox/backends/microsandbox.d.ts

@@ -1,5 +1,5 @@
 import type { SandboxBackend } from "#public/definitions/sandbox-backend.js";
-import type { MicrosandboxBootstrapUseOptions, MicrosandboxCreateOptions, MicrosandboxSessionUseOptions } from "#public/sandbox/microsandbox-sandbox.js";
+import type { MicrosandboxBootstrapUseOptions, MicrosandboxSandboxCreateOptions, MicrosandboxSessionUseOptions } from "#public/sandbox/microsandbox-sandbox.js";
 /**
  * Constructs the microsandbox sandbox backend: lightweight local VMs
  * via [microsandbox](https://www.npmjs.com/package/microsandbox) with
@@ -14,4 +14,4 @@ import type { MicrosandboxBootstrapUseOptions, MicrosandboxCreateOptions, Micros
  * Configuring this backend pins it unconditionally — when you want
  * fallback behavior, use `defaultBackend()` instead.
  */
-export declare function microsandbox(opts?: MicrosandboxCreateOptions): SandboxBackend<MicrosandboxBootstrapUseOptions, MicrosandboxSessionUseOptions>;
+export declare function microsandbox(opts?: MicrosandboxSandboxCreateOptions): SandboxBackend<MicrosandboxBootstrapUseOptions, MicrosandboxSessionUseOptions>;

package/dist/src/public/sandbox/microsandbox-sandbox.d.ts

@@ -8,7 +8,7 @@ import type { SandboxNetworkPolicy } from "#shared/sandbox-network-policy.js";
  * stay stable while the underlying runtime evolves. Supported hosts:
  * macOS on Apple Silicon, or Linux (glibc) with KVM enabled.
  */
-export interface MicrosandboxCreateOptions {
+export interface MicrosandboxSandboxCreateOptions {
     /**
      * OCI image used as the base runtime. eve prepares this image with
      * Bash, the framework workspace, and the sandbox user before authored

package/dist/src/public/sandbox/microsandbox.d.ts

@@ -1,2 +1,2 @@
 export { microsandbox } from "#public/sandbox/backends/microsandbox.js";
-export type { MicrosandboxBootstrapUseOptions, MicrosandboxCreateOptions, MicrosandboxSessionUseOptions, } from "#public/sandbox/microsandbox-sandbox.js";
+export type { MicrosandboxBootstrapUseOptions, MicrosandboxSandboxCreateOptions, MicrosandboxSessionUseOptions, } from "#public/sandbox/microsandbox-sandbox.js";

package/dist/src/runtime/agent/bootstrap.d.ts

@@ -2,6 +2,7 @@ import type { PreparedRuntimeTool } from "#runtime/sessions/turn.js";
 import type { ResolvedAgent } from "#runtime/types.js";
 import type { WorkspaceRuntimeSpec } from "#runtime/workspace/types.js";
 import type { InternalAgentModelDefinition } from "#shared/agent-definition.js";
+import type { ModuleSourceRef } from "#shared/source-ref.js";
 import type { AvailableSkillDescription } from "#execution/skills/instructions.js";
 /**
  * Fixed internal model reference used only by the framework-owned bootstrap
@@ -12,6 +13,12 @@ export declare const BOOTSTRAP_RUNTIME_MODEL_ID = "eve-bootstrap-model";
  * Runtime-owned model identifier prepared for one harness turn.
  */
 export type RuntimeModelReference = Readonly<InternalAgentModelDefinition>;
+/**
+ * Runtime-owned reference to a dynamic model resolver authored in `agent.ts`.
+ */
+export type RuntimeDynamicModelReference = Readonly<ModuleSourceRef & {
+    readonly eventNames: readonly string[];
+}>;
 /**
  * Minimal runtime-owned agent shape prepared for one harness turn.
  */
@@ -25,6 +32,7 @@ export interface RuntimeTurnAgent {
      * When omitted, the harness uses the active turn model for compaction.
      */
     readonly compactionModel?: RuntimeModelReference;
+    readonly dynamicModel?: RuntimeDynamicModelReference;
     readonly model: RuntimeModelReference;
     readonly nodeId?: string;
     readonly outputSchema?: ResolvedAgent["config"]["outputSchema"];

package/dist/src/runtime/agent/bootstrap.js

@@ -1 +1 @@
-import{composeRuntimeBasePrompt}from"#runtime/prompt/compose.js";const BOOTSTRAP_RUNTIME_MODEL_ID=`eve-bootstrap-model`,BOOTSTRAP_RUNTIME_SYSTEM_PROMPT=`You are the eve bootstrap agent. Be concise, stay grounded in the current conversation, and do not assume tools are available unless the runtime provides them.`;function createResolvedRuntimeTurnAgent(t){let n=t.agent;return{availableSkills:n.skills.map(e=>({description:e.description,name:e.name})),id:n.config.name,instructions:composeRuntimeBasePrompt({connections:n.connections,instructions:n.instructions,toolsAvailable:t.tools.length>0,workspaceSpec:n.workspaceSpec}),compactionModel:n.config.compaction?.model,model:n.config.model,nodeId:t.nodeId,outputSchema:n.config.outputSchema,reasoning:n.config.reasoning,tools:[...t.tools],workspaceSpec:n.workspaceSpec}}export{BOOTSTRAP_RUNTIME_MODEL_ID,BOOTSTRAP_RUNTIME_SYSTEM_PROMPT,createResolvedRuntimeTurnAgent};
+import{composeRuntimeBasePrompt}from"#runtime/prompt/compose.js";const BOOTSTRAP_RUNTIME_MODEL_ID=`eve-bootstrap-model`,BOOTSTRAP_RUNTIME_SYSTEM_PROMPT=`You are the eve bootstrap agent. Be concise, stay grounded in the current conversation, and do not assume tools are available unless the runtime provides them.`;function createResolvedRuntimeTurnAgent(t){let n=t.agent;return{availableSkills:n.skills.map(e=>({description:e.description,name:e.name})),id:n.config.name,instructions:composeRuntimeBasePrompt({connections:n.connections,instructions:n.instructions,toolsAvailable:t.tools.length>0,workspaceSpec:n.workspaceSpec}),compactionModel:n.config.compaction?.model,dynamicModel:n.config.dynamicModel,model:n.config.model,nodeId:t.nodeId,outputSchema:n.config.outputSchema,reasoning:n.config.reasoning,tools:[...t.tools],workspaceSpec:n.workspaceSpec}}export{BOOTSTRAP_RUNTIME_MODEL_ID,BOOTSTRAP_RUNTIME_SYSTEM_PROMPT,createResolvedRuntimeTurnAgent};

package/dist/src/runtime/agent/resolve-model.d.ts

@@ -1,14 +1,29 @@
 import type { LanguageModel } from "ai";
 import type { CompiledModuleMap } from "#compiler/module-map.js";
-import type { RuntimeModelReference } from "#runtime/agent/bootstrap.js";
+import type { RuntimeDynamicModelReference, RuntimeModelReference } from "#runtime/agent/bootstrap.js";
 import { shouldMockAuthoredRuntimeModels } from "#runtime/agent/mock-model-adapter.js";
+import { type PublicAgentDynamicModelDefinition, type PublicAgentDynamicModelResult } from "#shared/agent-definition.js";
 export { shouldMockAuthoredRuntimeModels };
 /** Loaded compiled-module scope used to resolve source-backed runtime models. */
 export interface RuntimeModelResolutionScope {
     readonly moduleMap: CompiledModuleMap;
     readonly nodeId: string | undefined;
 }
+export interface ResolvedRuntimeModelSelection {
+    /** Live provider instance; absent for string selections, which resolve through the reference so mock/bootstrap adapters keep precedence. */
+    readonly model?: LanguageModel;
+    readonly reference: RuntimeModelReference;
+}
 /**
  * Resolves one runtime model reference into the active language model.
  */
 export declare function resolveRuntimeModelReference(reference: RuntimeModelReference, scope?: RuntimeModelResolutionScope): Promise<LanguageModel>;
+export declare function loadDynamicRuntimeModelDefinition(input: {
+    readonly dynamicModel: RuntimeDynamicModelReference;
+    readonly scope: RuntimeModelResolutionScope;
+}): Promise<PublicAgentDynamicModelDefinition>;
+export declare function normalizeDynamicRuntimeModelResult(input: {
+    readonly fallback: RuntimeModelReference;
+    readonly result: NonNullable<PublicAgentDynamicModelResult>;
+}): ResolvedRuntimeModelSelection;
+export declare function isRuntimeLanguageModel(value: unknown): value is LanguageModel;

package/dist/src/runtime/agent/resolve-model.js

@@ -1 +1 @@
-import{normalizeAgentDefinition}from"#internal/authored-definition/core.js";import{loadResolvedModuleExport}from"#runtime/resolve-helpers.js";import{resolveBootstrapRuntimeModel}from"#runtime/agent/bootstrap-model.js";import{resolveMockAuthoredRuntimeModel,shouldMockAuthoredRuntimeModels}from"#runtime/agent/mock-model-adapter.js";async function resolveRuntimeModelReference(e,t){let i=resolveBootstrapRuntimeModel(e);if(i!==null)return i;let a=resolveMockAuthoredRuntimeModel(e);return a===null?isSourceBackedRuntimeModelReference(e)?await loadSourceBackedRuntimeModelReference(e,t):e.id:a}async function loadSourceBackedRuntimeModelReference(n,r){if(r===void 0)throw Error(`Expected a compiled module-map scope to resolve the authored runtime model "${n.id}".`);let i=normalizeAgentDefinition(await loadResolvedModuleExport({definition:n.source,kindLabel:`runtime model "${n.id}"`,moduleMap:r.moduleMap,nodeId:r.nodeId}),`Expected the authored agent config export "${n.source.exportName??`default`}" from "${n.source.logicalPath}" to match the public eve shape.`).model;if(i===void 0)throw Error(`Expected the authored agent config export "${n.source.exportName??`default`}" from "${n.source.logicalPath}" to provide a runtime model.`);return i}function isSourceBackedRuntimeModelReference(e){return e.source!==void 0}export{resolveRuntimeModelReference,shouldMockAuthoredRuntimeModels};
+import{normalizeAgentDefinition}from"#internal/authored-definition/core.js";import{formatLanguageModelGatewayId}from"#internal/runtime-model.js";import{parseJsonObject}from"#shared/json.js";import{isDynamicModelDefinition}from"#shared/agent-definition.js";import{loadResolvedModuleExport}from"#runtime/resolve-helpers.js";import{resolveBootstrapRuntimeModel}from"#runtime/agent/bootstrap-model.js";import{resolveMockAuthoredRuntimeModel,shouldMockAuthoredRuntimeModels}from"#runtime/agent/mock-model-adapter.js";async function resolveRuntimeModelReference(e,t){let n=resolveBootstrapRuntimeModel(e);if(n!==null)return n;let r=resolveMockAuthoredRuntimeModel(e);return r===null?isSourceBackedRuntimeModelReference(e)?await loadSourceBackedRuntimeModelReference(e,t):e.id:r}async function loadSourceBackedRuntimeModelReference(t,n){if(n===void 0)throw Error(`Expected a compiled module-map scope to resolve the authored runtime model "${t.id}".`);let a=normalizeAgentDefinition(await loadResolvedModuleExport({definition:t.source,kindLabel:`runtime model "${t.id}"`,moduleMap:n.moduleMap,nodeId:n.nodeId}),`Expected the authored agent config export "${t.source.exportName??`default`}" from "${t.source.logicalPath}" to match the public eve shape.`).model;if(a===void 0)throw Error(`Expected the authored agent config export "${t.source.exportName??`default`}" from "${t.source.logicalPath}" to provide a runtime model.`);return isDynamicModelDefinition(a)?a.fallback:a}function isSourceBackedRuntimeModelReference(e){return e.source!==void 0}async function loadDynamicRuntimeModelDefinition(t){let n=normalizeAgentDefinition(await loadResolvedModuleExport({definition:t.dynamicModel,kindLabel:`dynamic runtime model`,moduleMap:t.scope.moduleMap,nodeId:t.scope.nodeId}),`Expected the authored agent config export "${t.dynamicModel.exportName??`default`}" from "${t.dynamicModel.logicalPath}" to match the public eve shape.`).model;if(!isDynamicModelDefinition(n))throw Error(`Expected the authored agent config export "${t.dynamicModel.exportName??`default`}" from "${t.dynamicModel.logicalPath}" to provide a dynamic model definition.`);return n}function normalizeDynamicRuntimeModelResult(e){let n=normalizeDynamicModelSelection(e.result);validateDynamicModelSelection(n);let r=n.modelOptions?.providerOptions===void 0?e.fallback.providerOptions:parseProviderOptionsRecord(n.modelOptions.providerOptions),i=n.modelContextWindowTokens;return typeof n.model==`string`?{reference:{id:formatLanguageModelGatewayId(n.model),contextWindowTokens:i,providerOptions:r}}:(validateRuntimeLanguageModel(n.model),{model:n.model,reference:{id:formatLanguageModelGatewayId(n.model),contextWindowTokens:i,providerOptions:r}})}const DYNAMIC_MODEL_SELECTION_KEYS=new Set([`model`,`modelContextWindowTokens`,`modelOptions`]);function validateDynamicModelSelection(e){let t=Object.keys(e).filter(e=>!DYNAMIC_MODEL_SELECTION_KEYS.has(e));if(t.length>0)throw Error(`Dynamic model resolver returned a selection with unknown key(s): ${t.join(`, `)}. Expected { model, modelContextWindowTokens?, modelOptions? }.`);let n=e.modelContextWindowTokens;if(n!==void 0&&(!Number.isInteger(n)||n<=0))throw Error(`Dynamic model resolver returned an invalid modelContextWindowTokens value. Expected a positive integer.`)}function normalizeDynamicModelSelection(e){return isModelSelectionDefinition(e)?e:{model:e}}function isModelSelectionDefinition(e){return typeof e==`object`&&!!e&&`model`in e&&!isRuntimeLanguageModel(e)}function validateRuntimeLanguageModel(e){if(!isRuntimeLanguageModel(e))throw Error(`Dynamic model resolver returned an invalid model. Return an AI Gateway model id string, an AI SDK language model, or { model, modelContextWindowTokens?, modelOptions? }.`)}function isRuntimeLanguageModel(e){if(typeof e!=`object`||!e)return!1;let t=e;return(t.specificationVersion===`v2`||t.specificationVersion===`v3`||t.specificationVersion===`v4`)&&typeof t.provider==`string`&&typeof t.modelId==`string`&&typeof t.doGenerate==`function`&&typeof t.doStream==`function`}function parseProviderOptionsRecord(e){if(e===void 0)return;let t={};for(let[r,i]of Object.entries(e))t[r]=parseJsonObject(i);return t}export{isRuntimeLanguageModel,loadDynamicRuntimeModelDefinition,normalizeDynamicRuntimeModelResult,resolveRuntimeModelReference,shouldMockAuthoredRuntimeModels};

package/dist/src/runtime/hooks/registry.d.ts

@@ -1,3 +1,4 @@
+import type { HandleMessageStreamEvent } from "#protocol/message.js";
 import type { StreamEventHook } from "../../public/definitions/hook.js";
 import type { ResolvedHookDefinition } from "../types.js";
 /**
@@ -8,7 +9,7 @@ import type { ResolvedHookDefinition } from "../types.js";
  */
 interface RuntimeStreamEventHookEntry {
     readonly slug: string;
-    readonly handler: StreamEventHook<unknown>;
+    readonly handler: StreamEventHook<HandleMessageStreamEvent>;
     readonly eventType: string;
 }
 /**

package/dist/src/runtime/prompt/compose.d.ts

@@ -1,4 +1,4 @@
-import type { ResolvedConnectionDefinition, ResolvedInstructions, ResolvedSkillDefinition } from "#runtime/types.js";
+import type { ResolvedConnectionDefinition, ResolvedInstructionsDefinition, ResolvedSkillDefinition } from "#runtime/types.js";
 import type { WorkspaceRuntimeSpec } from "#runtime/workspace/types.js";
 /**
  * Input for composing the base authored instructions prompt for one
@@ -6,7 +6,7 @@ import type { WorkspaceRuntimeSpec } from "#runtime/workspace/types.js";
  */
 interface ComposeRuntimeBasePromptInput {
     connections?: readonly ResolvedConnectionDefinition[];
-    instructions?: ResolvedInstructions;
+    instructions?: ResolvedInstructionsDefinition;
     skills?: readonly ResolvedSkillDefinition[];
     toolsAvailable?: boolean;
     workspaceSpec?: WorkspaceRuntimeSpec;

package/dist/src/runtime/resolve-agent.js

@@ -1 +1 @@
-import{ResolveAgentError,createResolvedModuleSourceRef}from"#runtime/resolve-helpers.js";import{resolveChannelDefinition}from"#runtime/resolve-channel.js";import{resolveConnectionDefinition}from"#runtime/resolve-connection.js";import{resolveHookDefinition}from"#runtime/resolve-hook.js";import{resolveSandboxDefinition}from"#runtime/resolve-sandbox.js";import{resolveDynamicInstructionsDefinition}from"#runtime/resolve-dynamic-instructions.js";import{resolveDynamicSkillDefinition}from"#runtime/resolve-dynamic-skill.js";import{resolveDynamicToolDefinition}from"#runtime/resolve-dynamic-tool.js";import{resolveToolDefinition}from"#runtime/resolve-tool.js";async function resolveAgent(e){let t=e.manifest.skills.map(e=>({...e,metadata:e.metadata===void 0?void 0:{...e.metadata}})),r=[],i=[];for(let t of e.manifest.channels){if(t.kind===`disabled`){i.push(t.name);continue}r.push(await resolveChannelDefinition(t,e.moduleMap,e.nodeId))}let a=await Promise.all(e.manifest.tools.map(t=>resolveToolDefinition(t,e.moduleMap,e.nodeId))),o=await Promise.all((e.manifest.dynamicInstructions??[]).map(t=>resolveDynamicInstructionsDefinition(t,e.moduleMap,e.nodeId))),s=await Promise.all((e.manifest.dynamicSkills??[]).map(t=>resolveDynamicSkillDefinition(t,e.moduleMap,e.nodeId))),c=await Promise.all(e.manifest.dynamicTools.map(t=>resolveDynamicToolDefinition(t,e.moduleMap,e.nodeId))),l=await Promise.all(e.manifest.hooks.map(t=>resolveHookDefinition(t,e.moduleMap,e.nodeId))),u=await Promise.all(e.manifest.connections.map(t=>resolveConnectionDefinition(t,e.moduleMap,e.nodeId))),d=e.manifest.sandbox===null?null:await resolveSandboxDefinition(e.manifest.sandbox,e.moduleMap,e.nodeId),f=createResolvedInstructions(e.manifest.instructions),p=e.manifest.workspaceResourceRoot,m={channels:r,config:createResolvedAgentConfig(e.manifest),connections:u,disabledFrameworkChannels:i,disabledFrameworkTools:[...e.manifest.disabledFrameworkTools],workflowEnabled:e.manifest.workflowEnabled,dynamicInstructionsResolvers:o,dynamicSkillResolvers:s,dynamicToolResolvers:c,hooks:l,metadata:{agentRoot:e.manifest.agentRoot,appRoot:e.manifest.appRoot,diagnosticsSummary:e.manifest.diagnosticsSummary},sandbox:d,workspaceResourceRoot:p,skills:t,tools:a,workspaceSpec:{rootEntries:[...p.rootEntries]}};return f===void 0?m:{...m,instructions:f}}function createResolvedInstructions(e){if(e!==void 0)return{name:e.name,logicalPath:e.logicalPath,markdown:e.markdown,sourceId:e.sourceId,sourceKind:e.sourceKind}}function createResolvedAgentConfig(e){let n={model:e.config.model.source===void 0?{id:e.config.model.id,contextWindowTokens:e.config.model.contextWindowTokens,providerOptions:e.config.model.providerOptions}:{contextWindowTokens:e.config.model.contextWindowTokens,id:e.config.model.id,providerOptions:e.config.model.providerOptions,source:{exportName:e.config.model.source.exportName,sourceKind:`module`,logicalPath:e.config.model.source.logicalPath,sourceId:e.config.model.source.sourceId}},name:e.config.name};if(e.config.compaction!==void 0){let t={};e.config.compaction.model!==void 0&&(t.model=e.config.compaction.model.source===void 0?{contextWindowTokens:e.config.compaction.model.contextWindowTokens,id:e.config.compaction.model.id,providerOptions:e.config.compaction.model.providerOptions}:{contextWindowTokens:e.config.compaction.model.contextWindowTokens,id:e.config.compaction.model.id,providerOptions:e.config.compaction.model.providerOptions,source:{exportName:e.config.compaction.model.source.exportName,sourceKind:`module`,logicalPath:e.config.compaction.model.source.logicalPath,sourceId:e.config.compaction.model.source.sourceId}}),e.config.compaction.thresholdPercent!==void 0&&(t.thresholdPercent=e.config.compaction.thresholdPercent),n.compaction=t}return e.config.experimental!==void 0&&(n.experimental={workflow:e.config.experimental.workflow===void 0?void 0:{world:e.config.experimental.workflow.world}}),e.config.outputSchema!==void 0&&(n.outputSchema=e.config.outputSchema),e.config.reasoning!==void 0&&(n.reasoning=e.config.reasoning),e.config.source!==void 0&&(n.source=createResolvedModuleSourceRef(e.config.source)),e.config.limits!==void 0&&(n.limits={maxSubagentDepth:e.config.limits.maxSubagentDepth,maxSubagents:e.config.limits.maxSubagents,maxInputTokensPerSession:e.config.limits.maxInputTokensPerSession,maxOutputTokensPerSession:e.config.limits.maxOutputTokensPerSession}),n}export{ResolveAgentError,resolveAgent};
+import{ResolveAgentError,createResolvedModuleSourceRef}from"#runtime/resolve-helpers.js";import{resolveChannelDefinition}from"#runtime/resolve-channel.js";import{resolveConnectionDefinition}from"#runtime/resolve-connection.js";import{resolveHookDefinition}from"#runtime/resolve-hook.js";import{resolveSandboxDefinition}from"#runtime/resolve-sandbox.js";import{resolveDynamicInstructionsDefinition}from"#runtime/resolve-dynamic-instructions.js";import{resolveDynamicSkillDefinition}from"#runtime/resolve-dynamic-skill.js";import{resolveDynamicToolDefinition}from"#runtime/resolve-dynamic-tool.js";import{resolveToolDefinition}from"#runtime/resolve-tool.js";async function resolveAgent(e){let t=e.manifest.skills.map(e=>({...e,metadata:e.metadata===void 0?void 0:{...e.metadata}})),r=[],i=[];for(let t of e.manifest.channels){if(t.kind===`disabled`){i.push(t.name);continue}r.push(await resolveChannelDefinition(t,e.moduleMap,e.nodeId))}let a=await Promise.all(e.manifest.tools.map(t=>resolveToolDefinition(t,e.moduleMap,e.nodeId))),o=await Promise.all((e.manifest.dynamicInstructions??[]).map(t=>resolveDynamicInstructionsDefinition(t,e.moduleMap,e.nodeId))),s=await Promise.all((e.manifest.dynamicSkills??[]).map(t=>resolveDynamicSkillDefinition(t,e.moduleMap,e.nodeId))),c=await Promise.all(e.manifest.dynamicTools.map(t=>resolveDynamicToolDefinition(t,e.moduleMap,e.nodeId))),l=await Promise.all(e.manifest.hooks.map(t=>resolveHookDefinition(t,e.moduleMap,e.nodeId))),u=await Promise.all(e.manifest.connections.map(t=>resolveConnectionDefinition(t,e.moduleMap,e.nodeId))),d=e.manifest.sandbox===null?null:await resolveSandboxDefinition(e.manifest.sandbox,e.moduleMap,e.nodeId),f=createResolvedInstructionsDefinition(e.manifest.instructions),p=e.manifest.workspaceResourceRoot,m={channels:r,config:createResolvedAgentConfig(e.manifest),connections:u,disabledFrameworkChannels:i,disabledFrameworkTools:[...e.manifest.disabledFrameworkTools],workflowEnabled:e.manifest.workflowEnabled,dynamicInstructionsResolvers:o,dynamicSkillResolvers:s,dynamicToolResolvers:c,hooks:l,metadata:{agentRoot:e.manifest.agentRoot,appRoot:e.manifest.appRoot,diagnosticsSummary:e.manifest.diagnosticsSummary},sandbox:d,workspaceResourceRoot:p,skills:t,tools:a,workspaceSpec:{rootEntries:[...p.rootEntries]}};return f===void 0?m:{...m,instructions:f}}function createResolvedInstructionsDefinition(e){if(e!==void 0)return{name:e.name,logicalPath:e.logicalPath,markdown:e.markdown,sourceId:e.sourceId,sourceKind:e.sourceKind}}function createResolvedAgentConfig(e){let n={model:e.config.model.source===void 0?{id:e.config.model.id,contextWindowTokens:e.config.model.contextWindowTokens,providerOptions:e.config.model.providerOptions}:{contextWindowTokens:e.config.model.contextWindowTokens,id:e.config.model.id,providerOptions:e.config.model.providerOptions,source:{exportName:e.config.model.source.exportName,sourceKind:`module`,logicalPath:e.config.model.source.logicalPath,sourceId:e.config.model.source.sourceId}},name:e.config.name};if(e.config.compaction!==void 0){let t={};e.config.compaction.model!==void 0&&(t.model=e.config.compaction.model.source===void 0?{contextWindowTokens:e.config.compaction.model.contextWindowTokens,id:e.config.compaction.model.id,providerOptions:e.config.compaction.model.providerOptions}:{contextWindowTokens:e.config.compaction.model.contextWindowTokens,id:e.config.compaction.model.id,providerOptions:e.config.compaction.model.providerOptions,source:{exportName:e.config.compaction.model.source.exportName,sourceKind:`module`,logicalPath:e.config.compaction.model.source.logicalPath,sourceId:e.config.compaction.model.source.sourceId}}),e.config.compaction.thresholdPercent!==void 0&&(t.thresholdPercent=e.config.compaction.thresholdPercent),n.compaction=t}return e.config.dynamicModel!==void 0&&(n.dynamicModel={...createResolvedModuleSourceRef(e.config.dynamicModel),eventNames:[...e.config.dynamicModel.eventNames]}),e.config.experimental!==void 0&&(n.experimental={workflow:e.config.experimental.workflow===void 0?void 0:{world:e.config.experimental.workflow.world}}),e.config.outputSchema!==void 0&&(n.outputSchema=e.config.outputSchema),e.config.reasoning!==void 0&&(n.reasoning=e.config.reasoning),e.config.source!==void 0&&(n.source=createResolvedModuleSourceRef(e.config.source)),e.config.limits!==void 0&&(n.limits={maxSubagentDepth:e.config.limits.maxSubagentDepth,maxSubagents:e.config.limits.maxSubagents,maxInputTokensPerSession:e.config.limits.maxInputTokensPerSession,maxOutputTokensPerSession:e.config.limits.maxOutputTokensPerSession}),n}export{ResolveAgentError,resolveAgent};

package/dist/src/runtime/schedules/register.d.ts

@@ -1,4 +1,4 @@
-import type { ResolvedSchedule } from "#runtime/types.js";
+import type { ResolvedScheduleDefinition } from "#runtime/types.js";
 /**
  * Stable Nitro task-name prefix for framework-owned authored schedules.
  */
@@ -32,4 +32,4 @@ export declare class ScheduleRegistrationError extends Error {
  * Creates stable registration inputs for Nitro's task and cron surfaces from
  * resolved authored schedules.
  */
-export declare function createScheduleRegistrations(schedules: readonly ResolvedSchedule[]): ScheduleRegistration[];
+export declare function createScheduleRegistrations(schedules: readonly ResolvedScheduleDefinition[]): ScheduleRegistration[];

package/dist/src/runtime/schedules/resolve-schedule.d.ts

@@ -1,6 +1,6 @@
 import type { CompiledAgentManifest } from "#compiler/manifest.js";
 import type { RuntimeCompiledArtifactsSource } from "#runtime/compiled-artifacts-source.js";
-import type { ResolvedSchedule } from "#runtime/types.js";
+import type { ResolvedScheduleDefinition } from "#runtime/types.js";
 /**
  * Input for resolving authored schedules from the compiled manifest.
  */
@@ -17,15 +17,15 @@ interface LoadResolvedCompiledSchedulesInput {
 /**
  * Resolves runtime-owned schedules from the compiled manifest.
  */
-export declare function resolveSchedules(input: ResolveSchedulesInput): Promise<ResolvedSchedule[]>;
+export declare function resolveSchedules(input: ResolveSchedulesInput): Promise<ResolvedScheduleDefinition[]>;
 /**
  * Loads the compiled manifest, then resolves authored schedules into
  * runtime-owned schedule models.
  */
-export declare function loadResolvedCompiledSchedules(input: LoadResolvedCompiledSchedulesInput): Promise<ResolvedSchedule[]>;
+export declare function loadResolvedCompiledSchedules(input: LoadResolvedCompiledSchedulesInput): Promise<ResolvedScheduleDefinition[]>;
 /**
  * Loads and resolves one compiled authored schedule from its registered Nitro
  * task name.
  */
-export declare function loadResolvedCompiledScheduleByTaskName(taskName: string, input: LoadResolvedCompiledSchedulesInput): Promise<ResolvedSchedule>;
+export declare function loadResolvedCompiledScheduleByTaskName(taskName: string, input: LoadResolvedCompiledSchedulesInput): Promise<ResolvedScheduleDefinition>;
 export {};

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

@@ -4,6 +4,7 @@ import type { CompiledChannel } from "#channel/compiled-channel.js";
 import type { NormalizedChannelCorsOptions } from "#channel/cors.js";
 import type { HeadersValue } from "#client/types.js";
 import type { DiscoverDiagnosticsSummary } from "#discover/diagnostics.js";
+import type { HandleMessageStreamEvent } from "#protocol/message.js";
 import type { ChannelRouteMethod, RouteContext } from "#public/definitions/channel.js";
 import type { RouteHandler, WebSocketRouteHandler } from "#channel/routes.js";
 import type { OutboundAuthFn } from "#public/agents/auth.js";
@@ -20,6 +21,7 @@ import type { Node } from "#shared/node.js";
 import type { SourceRef, ModuleSourceRef, SkillPackageSourceRef, MarkdownSourceRef } from "#shared/source-ref.js";
 import type { NamedSkillDefinition } from "#shared/skill-definition.js";
 import type { InternalAgentDefinition } from "#shared/agent-definition.js";
+import type { RuntimeDynamicModelReference } from "#runtime/agent/bootstrap.js";
 import type { InternalToolDefinitionWithExecuteFn } from "#shared/tool-definition.js";
 import type { SandboxBackend } from "#shared/sandbox-backend.js";
 import type { SandboxBootstrapContext, SandboxSessionContext } from "#shared/sandbox-definition.js";
@@ -35,7 +37,7 @@ export type ResolvedModuleSourceRef = Readonly<ModuleSourceRef>;
  * the resulting markdown is captured here. Runtime never re-evaluates
  * the module.
  */
-export type ResolvedInstructions = Readonly<SourceRef & {
+export type ResolvedInstructionsDefinition = Readonly<SourceRef & {
     name: string;
     markdown: string;
 } & (Omit<MarkdownSourceRef<undefined>, "definition"> | ModuleSourceRef)>;
@@ -55,7 +57,7 @@ export type ResolvedSkillDefinition = Readonly<NamedSkillDefinition & (Omit<Mark
  * a {@link ScheduleHandlerArgs}-shaped argument; for the markdown form
  * the dispatcher synthesizes a channel-less SCHEDULE_ADAPTER run.
  */
-export type ResolvedSchedule = Readonly<SourceRef & {
+export type ResolvedScheduleDefinition = Readonly<SourceRef & {
     readonly cron: string;
     readonly name: string;
     readonly markdown?: string;
@@ -177,7 +179,7 @@ export interface ResolvedHookDefinition extends ResolvedModuleSourceRef {
      * wildcard if declared. Unknown keys are accepted at resolve time
      * and ignored at dispatch time.
      */
-    readonly events: Readonly<Record<string, StreamEventHook<unknown>>>;
+    readonly events: Readonly<Record<string, StreamEventHook<HandleMessageStreamEvent>>>;
 }
 /**
  * Runtime-owned authored channel definition resolved from the compiled
@@ -257,6 +259,7 @@ export type ResolvedRuntimeDelegationNode = ResolvedRuntimeRemoteAgentNode | Res
  * Runtime-owned additive agent configuration resolved from `agent.ts`.
  */
 export type ResolvedAgentDefinition = Readonly<Omit<InternalAgentDefinition, "build" | "source"> & {
+    dynamicModel?: RuntimeDynamicModelReference;
     source?: Readonly<NonNullable<InternalAgentDefinition["source"]>>;
 }>;
 /**
@@ -334,7 +337,7 @@ export interface ResolvedAgent {
      * `instructions.{ts,...}`, or `undefined` when the agent does not
      * declare one.
      */
-    readonly instructions?: ResolvedInstructions;
+    readonly instructions?: ResolvedInstructionsDefinition;
     /**
      * Authored sandbox override for this agent, when one exists. `null`
      * means the agent uses the framework default sandbox unchanged.

package/dist/src/setup/scaffold/create/project.js

@@ -1,4 +1,4 @@
-import{pinnedNodeEngineMajor}from"../../node-engine.js";import{pathExists,writeTextFile}from"../files.js";import{resolveVersionToken}from"../version-tokens.js";import{applyPackageManagerWorkspaceConfiguration,isPackageManagerWorkspaceMember,patchWorkspaceRootPackageJson}from"../workspace-root.js";import{SUPPORTED_AUTHORED_MODULE_FILE_EXTENSIONS}from"../update/module-files.js";import{WEB_APP_TEMPLATE_FILES}from"./web-template.js";import{basename,join,resolve}from"node:path";import{mkdir,readdir,stat}from"node:fs/promises";const CURRENT_DIRECTORY_PROJECT_NAME=`.`,ALLOWED_CREATE_IN_PLACE_ENTRIES=new Set([`.DS_Store`,`.git`,`.gitkeep`,`.hg`]),DEFAULT_AI_PACKAGE_VERSION=`^7.0.0`,DEFAULT_CONNECT_PACKAGE_VERSION=`0.2.2`,DEFAULT_ZOD_PACKAGE_VERSION=`4.4.3`,DEFAULT_EVE_PACKAGE_CONTRACT={version:`0.21.1`,nodeEngine:`>=24`};function resolveEvePackageContract(e=DEFAULT_EVE_PACKAGE_CONTRACT){return{version:resolveVersionToken(`evePackage.version`,e.version),nodeEngine:resolveVersionToken(`evePackage.nodeEngine`,e.nodeEngine)}}function modelProviderSlug(e){let t=(e.split(`/`)[0]??``).replaceAll(/[^A-Za-z0-9._-]/gu,``);return t.length>0?t:`anthropic`}function byokProviderEnvVar(e){let t=modelProviderSlug(e).toUpperCase().replaceAll(/[^A-Z0-9]/gu,`_`);return`${/^[0-9]/.test(t)?`_`:``}${t}_API_KEY`}function agentTemplateFiles(e){return{"agent/agent.ts":BASE_AGENT_TEMPLATE.replaceAll(`__EVE_INIT_MODEL__`,e),"agent/channels/eve.ts":WEB_APP_TEMPLATE_FILES[`agent/channels/eve.ts`],"agent/instructions.md":AGENT_INSTRUCTIONS_TEMPLATE}}function renderTemplate(e,t){return e.replaceAll(`__EVE_INIT_APP_NAME__`,t.appName).replaceAll(`__EVE_INIT_MODEL__`,t.model).replaceAll(`__EVE_INIT_BYOK_PROVIDER__`,modelProviderSlug(t.model)).replaceAll(`__EVE_INIT_BYOK_ENV_VAR__`,byokProviderEnvVar(t.model)).replaceAll(`__EVE_INIT_PACKAGE_VERSION__`,formatEveDependencySpecifier(t.eveVersion)).replaceAll(`__EVE_INIT_AI_SDK_VERSION__`,t.aiPackageVersion).replaceAll(`__EVE_INIT_CONNECT_VERSION__`,t.connectPackageVersion).replaceAll(`__EVE_INIT_ZOD_VERSION__`,t.zodPackageVersion).replaceAll(`__EVE_INIT_TYPESCRIPT_VERSION__`,t.typescriptPackageVersion).replaceAll(`__EVE_INIT_TYPES_NODE_VERSION__`,t.nodeTypesVersion).replaceAll(`__EVE_INIT_NODE_ENGINE__`,t.nodeEngine)}function formatEveDependencySpecifier(e){return/^\d+\.\d+\.\d+(?:[-+][0-9A-Za-z-.]+)?$/.test(e)?`^${e}`:e}const BASE_AGENT_TEMPLATE=`import { defineAgent } from "eve";
+import{pinnedNodeEngineMajor}from"../../node-engine.js";import{pathExists,writeTextFile}from"../files.js";import{resolveVersionToken}from"../version-tokens.js";import{applyPackageManagerWorkspaceConfiguration,isPackageManagerWorkspaceMember,patchWorkspaceRootPackageJson}from"../workspace-root.js";import{SUPPORTED_AUTHORED_MODULE_FILE_EXTENSIONS}from"../update/module-files.js";import{WEB_APP_TEMPLATE_FILES}from"./web-template.js";import{basename,join,resolve}from"node:path";import{mkdir,readdir,stat}from"node:fs/promises";const CURRENT_DIRECTORY_PROJECT_NAME=`.`,ALLOWED_CREATE_IN_PLACE_ENTRIES=new Set([`.DS_Store`,`.git`,`.gitkeep`,`.hg`]),DEFAULT_AI_PACKAGE_VERSION=`^7.0.0`,DEFAULT_CONNECT_PACKAGE_VERSION=`0.2.2`,DEFAULT_ZOD_PACKAGE_VERSION=`4.4.3`,DEFAULT_EVE_PACKAGE_CONTRACT={version:`0.22.0`,nodeEngine:`>=24`};function resolveEvePackageContract(e=DEFAULT_EVE_PACKAGE_CONTRACT){return{version:resolveVersionToken(`evePackage.version`,e.version),nodeEngine:resolveVersionToken(`evePackage.nodeEngine`,e.nodeEngine)}}function modelProviderSlug(e){let t=(e.split(`/`)[0]??``).replaceAll(/[^A-Za-z0-9._-]/gu,``);return t.length>0?t:`anthropic`}function byokProviderEnvVar(e){let t=modelProviderSlug(e).toUpperCase().replaceAll(/[^A-Z0-9]/gu,`_`);return`${/^[0-9]/.test(t)?`_`:``}${t}_API_KEY`}function agentTemplateFiles(e){return{"agent/agent.ts":BASE_AGENT_TEMPLATE.replaceAll(`__EVE_INIT_MODEL__`,e),"agent/channels/eve.ts":WEB_APP_TEMPLATE_FILES[`agent/channels/eve.ts`],"agent/instructions.md":AGENT_INSTRUCTIONS_TEMPLATE}}function renderTemplate(e,t){return e.replaceAll(`__EVE_INIT_APP_NAME__`,t.appName).replaceAll(`__EVE_INIT_MODEL__`,t.model).replaceAll(`__EVE_INIT_BYOK_PROVIDER__`,modelProviderSlug(t.model)).replaceAll(`__EVE_INIT_BYOK_ENV_VAR__`,byokProviderEnvVar(t.model)).replaceAll(`__EVE_INIT_PACKAGE_VERSION__`,formatEveDependencySpecifier(t.eveVersion)).replaceAll(`__EVE_INIT_AI_SDK_VERSION__`,t.aiPackageVersion).replaceAll(`__EVE_INIT_CONNECT_VERSION__`,t.connectPackageVersion).replaceAll(`__EVE_INIT_ZOD_VERSION__`,t.zodPackageVersion).replaceAll(`__EVE_INIT_TYPESCRIPT_VERSION__`,t.typescriptPackageVersion).replaceAll(`__EVE_INIT_TYPES_NODE_VERSION__`,t.nodeTypesVersion).replaceAll(`__EVE_INIT_NODE_ENGINE__`,t.nodeEngine)}function formatEveDependencySpecifier(e){return/^\d+\.\d+\.\d+(?:[-+][0-9A-Za-z-.]+)?$/.test(e)?`^${e}`:e}const BASE_AGENT_TEMPLATE=`import { defineAgent } from "eve";
 
 export default defineAgent({
   model: "__EVE_INIT_MODEL__",