eve 0.5.4 → 0.6.0-beta.3

package/dist/src/react/use-eve-agent.d.ts

@@ -0,0 +1,76 @@
+import { type EveAgentStoreCallbacks, type EveAgentStoreSnapshot, type EveAgentStoreStatus, type PrepareSend } from "#client/eve-agent-store.js";
+import type { EveAgentReducer } from "#client/reducer.js";
+import type { ClientSession } from "#client/session.js";
+import { type EveMessageData } from "#client/message-reducer.js";
+import type { HandleMessageStreamEvent } from "#protocol/message.js";
+import type { ClientAuth, HeadersValue, SendTurnPayload, SessionState } from "#client/types.js";
+export type { PrepareSend };
+/**
+ * Lifecycle status of an Eve agent session.
+ *
+ * - `"ready"`: idle, accepting a new turn.
+ * - `"submitted"`: a turn was sent, no stream events received yet.
+ * - `"streaming"`: stream events are arriving for the active turn.
+ * - `"error"`: the last turn ended in a terminal failure (see `snapshot.error`).
+ */
+export type UseEveAgentStatus = EveAgentStoreStatus;
+/**
+ * Snapshot of an Eve agent session: `data` (the reducer projection), `events`
+ * (the authoritative server stream), `session` (resumable cursor), `status`,
+ * and `error`.
+ */
+export type UseEveAgentSnapshot<TData> = EveAgentStoreSnapshot<TData>;
+/**
+ * Snapshot plus commands returned by `useEveAgent`.
+ */
+export interface UseEveAgentHelpers<TData> extends UseEveAgentSnapshot<TData> {
+    /** Resets the session: aborts any in-flight turn, recreates the owned session, and clears events and projected data. */
+    readonly reset: () => void;
+    /** Sends a turn (message, HITL responses, and/or client context). Rejects if a turn is already in flight. */
+    readonly send: <TOutput = unknown>(input: SendTurnPayload<TOutput>) => Promise<void>;
+    /** Aborts the in-flight turn's stream, if any. */
+    readonly stop: () => void;
+}
+/**
+ * Configuration for creating or binding a React Eve agent session.
+ *
+ * Session configuration is read when the hook creates its internal store;
+ * remount the component to point at a different host, reducer, or session.
+ * Lifecycle callbacks update on every render.
+ *
+ * For credentials or headers that must change without remounting, pass function
+ * values to `auth` or `headers`; the client resolves those before each request.
+ */
+export interface UseEveAgentOptions<TData> extends EveAgentStoreCallbacks<TData> {
+    readonly auth?: ClientAuth;
+    readonly headers?: HeadersValue;
+    /**
+     * Base URL for Eve client requests.
+     *
+     * Defaults to same-origin Eve routes such as `/eve/v1/...`. Pass a same-origin
+     * prefix such as `/api` for an app-owned proxy, or an absolute origin to talk
+     * to an Eve server directly.
+     *
+     * @default ""
+     */
+    readonly host?: string;
+    readonly initialEvents?: readonly HandleMessageStreamEvent[];
+    readonly initialSession?: SessionState;
+    readonly maxReconnectAttempts?: number;
+    /**
+     * Project submitted user messages before Eve confirms them with a
+     * `message.received` stream event.
+     *
+     * Optimistic events are reducer-facing projection events only. They are not
+     * exposed through `events`, which remains the authoritative Eve stream.
+     *
+     * @default true
+     */
+    readonly optimistic?: boolean;
+    readonly reducer?: EveAgentReducer<TData>;
+    readonly session?: ClientSession;
+}
+export declare function useEveAgent(options?: UseEveAgentOptions<EveMessageData>): UseEveAgentHelpers<EveMessageData>;
+export declare function useEveAgent<TData>(options: UseEveAgentOptions<TData> & {
+    readonly reducer: EveAgentReducer<TData>;
+}): UseEveAgentHelpers<TData>;

package/dist/src/react/use-eve-agent.js

@@ -0,0 +1 @@
+import{EveAgentStore}from"#client/eve-agent-store.js";import{defaultMessageReducer}from"#client/message-reducer.js";import{useCallback,useMemo,useRef,useSyncExternalStore}from"react";function useEveAgent(n={}){let r=useRef(void 0);if(!r.current){let t=n.reducer??defaultMessageReducer();r.current=new EveAgentStore({auth:n.auth,headers:n.headers,host:n.host,initialEvents:n.initialEvents,initialSession:n.initialSession,maxReconnectAttempts:n.maxReconnectAttempts,optimistic:n.optimistic,reducer:t,session:n.session})}let i=r.current;i.setCallbacks({onError:n.onError,onEvent:n.onEvent,onFinish:n.onFinish,onSessionChange:n.onSessionChange,prepareSend:n.prepareSend});let a=useSyncExternalStore(useCallback(e=>i.subscribe(e),[i]),()=>i.snapshot,()=>i.snapshot),o=useCallback(()=>i.reset(),[i]),s=useCallback(e=>i.send(e),[i]),c=useCallback(()=>i.stop(),[i]);return useMemo(()=>({...a,reset:o,send:s,stop:c}),[o,s,a,c])}export{useEveAgent};

package/dist/src/runtime/actions/keys.d.ts

@@ -0,0 +1,11 @@
+import type { RuntimeActionRequest, RuntimeActionResult } from "#runtime/actions/types.js";
+/**
+ * Returns the stable match key used to pair one pending runtime action request
+ * with its resume result.
+ */
+export declare function getRuntimeActionRequestKey(action: RuntimeActionRequest): string;
+/**
+ * Returns the stable match key used to pair one runtime action result with its
+ * originating request.
+ */
+export declare function getRuntimeActionResultKey(result: RuntimeActionResult): string;

package/dist/src/runtime/actions/keys.js

@@ -0,0 +1 @@
+function getRuntimeActionRequestKey(e){switch(e.kind){case`load-skill`:return`runtime-action:${e.kind}:${e.callId}`;case`remote-agent-call`:return`subagent-call:${e.remoteAgentName}:${e.callId}`;case`subagent-call`:return`subagent-call:${e.subagentName}:${e.callId}`;case`tool-call`:return`tool-call:${e.toolName}:${e.callId}`}}function getRuntimeActionResultKey(e){switch(e.kind){case`load-skill-result`:return`runtime-action:load-skill:${e.callId}`;case`subagent-result`:return`subagent-call:${e.subagentName}:${e.callId}`;case`tool-result`:return`tool-call:${e.toolName}:${e.callId}`}}export{getRuntimeActionRequestKey,getRuntimeActionResultKey};

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

@@ -0,0 +1,150 @@
+import { z } from "#compiled/zod/index.js";
+/**
+ * Runtime-owned authored tool-call request surfaced by a harness and executed
+ * later by step-backed runtime code.
+ */
+export type RuntimeToolCallActionRequest = z.infer<typeof runtimeToolCallActionRequestSchema>;
+/**
+ * Zod schema for one runtime-owned authored tool-call action request.
+ */
+export declare const runtimeToolCallActionRequestSchema: z.ZodObject<{
+    callId: z.ZodString;
+    input: z.ZodType<import("../../shared/json.js").JsonObject, unknown, z.core.$ZodTypeInternals<import("../../shared/json.js").JsonObject, unknown>>;
+    kind: z.ZodLiteral<"tool-call">;
+    toolName: z.ZodString;
+}, z.core.$strict>;
+/**
+ * Runtime-owned subagent-call request surfaced by a harness and executed later
+ * by workflow-backed runtime code.
+ */
+export type RuntimeSubagentCallActionRequest = z.infer<typeof runtimeSubagentCallActionRequestSchema>;
+/**
+ * Zod schema for one runtime-owned subagent-call action request.
+ */
+declare const runtimeSubagentCallActionRequestSchema: z.ZodObject<{
+    callId: z.ZodString;
+    description: z.ZodString;
+    input: z.ZodType<import("../../shared/json.js").JsonObject, unknown, z.core.$ZodTypeInternals<import("../../shared/json.js").JsonObject, unknown>>;
+    kind: z.ZodLiteral<"subagent-call">;
+    name: z.ZodString;
+    nodeId: z.ZodString;
+    subagentName: z.ZodString;
+}, z.core.$strict>;
+/**
+ * Runtime-owned remote-agent-call request surfaced by a harness and executed
+ * later by workflow-backed runtime code.
+ */
+export type RuntimeRemoteAgentCallActionRequest = z.infer<typeof runtimeRemoteAgentCallActionRequestSchema>;
+/**
+ * Zod schema for one runtime-owned remote-agent-call action request.
+ */
+export declare const runtimeRemoteAgentCallActionRequestSchema: z.ZodObject<{
+    callId: z.ZodString;
+    description: z.ZodString;
+    input: z.ZodType<import("../../shared/json.js").JsonObject, unknown, z.core.$ZodTypeInternals<import("../../shared/json.js").JsonObject, unknown>>;
+    kind: z.ZodLiteral<"remote-agent-call">;
+    name: z.ZodString;
+    nodeId: z.ZodString;
+    remoteAgentName: z.ZodString;
+}, z.core.$strict>;
+/**
+ * Runtime-owned action request surfaced by a harness.
+ *
+ * Harness-native capabilities such as `bash` do not cross the harness boundary
+ * as runtime actions. Only runtime-executed requests use this taxonomy.
+ */
+type RuntimeLoadSkillActionRequest = z.infer<typeof runtimeLoadSkillActionRequestSchema>;
+/**
+ * Zod schema for one runtime-owned load-skill action request.
+ */
+declare const runtimeLoadSkillActionRequestSchema: z.ZodObject<{
+    callId: z.ZodString;
+    input: z.ZodType<import("../../shared/json.js").JsonObject, unknown, z.core.$ZodTypeInternals<import("../../shared/json.js").JsonObject, unknown>>;
+    kind: z.ZodLiteral<"load-skill">;
+}, z.core.$strict>;
+/**
+ * Runtime-owned action request surfaced by a harness.
+ *
+ * Harness-native capabilities such as `bash` do not cross the harness boundary
+ * as runtime actions. Only runtime-executed requests use this taxonomy.
+ */
+export type RuntimeActionRequest = RuntimeLoadSkillActionRequest | RuntimeRemoteAgentCallActionRequest | RuntimeSubagentCallActionRequest | RuntimeToolCallActionRequest;
+/**
+ * Zod schema for one runtime action request.
+ */
+export declare const runtimeActionRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    callId: z.ZodString;
+    input: z.ZodType<import("../../shared/json.js").JsonObject, unknown, z.core.$ZodTypeInternals<import("../../shared/json.js").JsonObject, unknown>>;
+    kind: z.ZodLiteral<"load-skill">;
+}, z.core.$strict>, z.ZodObject<{
+    callId: z.ZodString;
+    description: z.ZodString;
+    input: z.ZodType<import("../../shared/json.js").JsonObject, unknown, z.core.$ZodTypeInternals<import("../../shared/json.js").JsonObject, unknown>>;
+    kind: z.ZodLiteral<"remote-agent-call">;
+    name: z.ZodString;
+    nodeId: z.ZodString;
+    remoteAgentName: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    callId: z.ZodString;
+    description: z.ZodString;
+    input: z.ZodType<import("../../shared/json.js").JsonObject, unknown, z.core.$ZodTypeInternals<import("../../shared/json.js").JsonObject, unknown>>;
+    kind: z.ZodLiteral<"subagent-call">;
+    name: z.ZodString;
+    nodeId: z.ZodString;
+    subagentName: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    callId: z.ZodString;
+    input: z.ZodType<import("../../shared/json.js").JsonObject, unknown, z.core.$ZodTypeInternals<import("../../shared/json.js").JsonObject, unknown>>;
+    kind: z.ZodLiteral<"tool-call">;
+    toolName: z.ZodString;
+}, z.core.$strict>], "kind">;
+/**
+ * Runtime-owned authored tool-result projected back into a harness resume call.
+ */
+export type RuntimeToolResultActionResult = z.infer<typeof runtimeToolResultActionResultSchema>;
+/**
+ * Zod schema for one runtime-owned authored tool-result action result.
+ */
+declare const runtimeToolResultActionResultSchema: z.ZodObject<{
+    callId: z.ZodString;
+    isError: z.ZodOptional<z.ZodBoolean>;
+    kind: z.ZodLiteral<"tool-result">;
+    output: z.ZodType<import("../../shared/json.js").JsonValue, unknown, z.core.$ZodTypeInternals<import("../../shared/json.js").JsonValue, unknown>>;
+    toolName: z.ZodString;
+}, z.core.$strict>;
+/**
+ * Runtime-owned subagent result projected back into a harness resume call.
+ */
+export type RuntimeSubagentResultActionResult = z.infer<typeof runtimeSubagentResultActionResultSchema>;
+/**
+ * Zod schema for one runtime-owned subagent result action result.
+ */
+declare const runtimeSubagentResultActionResultSchema: z.ZodObject<{
+    callId: z.ZodString;
+    isError: z.ZodOptional<z.ZodBoolean>;
+    kind: z.ZodLiteral<"subagent-result">;
+    output: z.ZodType<import("../../shared/json.js").JsonValue, unknown, z.core.$ZodTypeInternals<import("../../shared/json.js").JsonValue, unknown>>;
+    subagentName: z.ZodString;
+}, z.core.$strict>;
+/**
+ * Runtime-owned action result produced by framework-owned loading code.
+ */
+type RuntimeLoadSkillActionResult = z.infer<typeof runtimeLoadSkillActionResultSchema>;
+/**
+ * Zod schema for one runtime-owned load-skill action result.
+ *
+ * The result still reports whether a skill became active during the turn; the
+ * action name reflects how the model requests those instructions.
+ */
+declare const runtimeLoadSkillActionResultSchema: z.ZodObject<{
+    callId: z.ZodString;
+    isError: z.ZodOptional<z.ZodBoolean>;
+    kind: z.ZodLiteral<"load-skill-result">;
+    output: z.ZodType<import("../../shared/json.js").JsonValue, unknown, z.core.$ZodTypeInternals<import("../../shared/json.js").JsonValue, unknown>>;
+    name: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/**
+ * Runtime-owned action result produced by framework-owned runtime code.
+ */
+export type RuntimeActionResult = RuntimeLoadSkillActionResult | RuntimeSubagentResultActionResult | RuntimeToolResultActionResult;
+export {};

package/dist/src/runtime/actions/types.js

@@ -0,0 +1 @@
+import{z}from"#compiled/zod/index.js";import{jsonObjectSchema,jsonValueSchema}from"#shared/json-schemas.js";const runtimeToolCallActionRequestSchema=z.object({callId:z.string(),input:jsonObjectSchema,kind:z.literal(`tool-call`),toolName:z.string()}).strict(),runtimeSubagentCallActionRequestSchema=z.object({callId:z.string(),description:z.string(),input:jsonObjectSchema,kind:z.literal(`subagent-call`),name:z.string(),nodeId:z.string(),subagentName:z.string()}).strict(),runtimeRemoteAgentCallActionRequestSchema=z.object({callId:z.string(),description:z.string(),input:jsonObjectSchema,kind:z.literal(`remote-agent-call`),name:z.string(),nodeId:z.string(),remoteAgentName:z.string()}).strict(),runtimeLoadSkillActionRequestSchema=z.object({callId:z.string(),input:jsonObjectSchema,kind:z.literal(`load-skill`)}).strict(),runtimeActionRequestSchema=z.discriminatedUnion(`kind`,[runtimeLoadSkillActionRequestSchema,runtimeRemoteAgentCallActionRequestSchema,runtimeSubagentCallActionRequestSchema,runtimeToolCallActionRequestSchema]);z.object({callId:z.string(),isError:z.boolean().optional(),kind:z.literal(`tool-result`),output:jsonValueSchema,toolName:z.string()}).strict(),z.object({callId:z.string(),isError:z.boolean().optional(),kind:z.literal(`subagent-result`),output:jsonValueSchema,subagentName:z.string()}).strict(),z.object({callId:z.string(),isError:z.boolean().optional(),kind:z.literal(`load-skill-result`),output:jsonValueSchema,name:z.string().optional()}).strict();export{runtimeActionRequestSchema,runtimeRemoteAgentCallActionRequestSchema,runtimeToolCallActionRequestSchema};

package/dist/src/runtime/agent/bootstrap-model-utils.d.ts

@@ -0,0 +1,37 @@
+import type { MockLanguageModelV3 } from "ai/test";
+export type BootstrapGenerateOptions = Parameters<MockLanguageModelV3["doGenerate"]>[0];
+export type BootstrapPrompt = BootstrapGenerateOptions["prompt"];
+export type BootstrapGenerateResult = Awaited<ReturnType<MockLanguageModelV3["doGenerate"]>>;
+type BootstrapStreamResult = Awaited<ReturnType<MockLanguageModelV3["doStream"]>>;
+/**
+ * Builds a deterministic `doGenerate` result from a text response and token
+ * estimates. Shared by the real bootstrap model and the authored-model mock.
+ */
+export declare function createBootstrapGenerateResult(input: {
+    readonly inputTokens: number;
+    readonly modelId: string;
+    readonly outputTokens: number;
+    readonly text: string;
+}): BootstrapGenerateResult;
+/**
+ * Converts a `doGenerate` result into a synchronous `doStream` result by
+ * replaying content parts through a `ReadableStream`.
+ */
+export declare function createBootstrapStreamResult(result: BootstrapGenerateResult): BootstrapStreamResult;
+/**
+ * Rough token estimate based on character length (1 token per 4 chars).
+ */
+export declare function estimateTokenCount(value: string): number;
+/**
+ * Extracts all text from a prompt message's content, joining text parts.
+ */
+export declare function getPromptContentText(content: BootstrapPrompt[number]["content"]): string;
+/**
+ * Returns the text from the last user message in the prompt, or `null`.
+ */
+export declare function getLastUserPromptText(prompt: BootstrapPrompt): string | null;
+/**
+ * Joins all message content in the prompt into a single string.
+ */
+export declare function getPromptText(prompt: BootstrapPrompt): string;
+export {};

package/dist/src/runtime/agent/bootstrap-model-utils.js

@@ -0,0 +1 @@
+const BOOTSTRAP_RESPONSE_TIMESTAMP=new Date(`2026-03-16T00:00:00.000Z`);function createBootstrapGenerateResult(t){return{content:[{text:t.text,type:`text`}],finishReason:{raw:void 0,unified:`stop`},response:{id:`bootstrap-response`,modelId:t.modelId,timestamp:BOOTSTRAP_RESPONSE_TIMESTAMP},usage:{inputTokens:{cacheRead:0,cacheWrite:0,noCache:t.inputTokens,total:t.inputTokens},outputTokens:{reasoning:0,text:t.outputTokens,total:t.outputTokens}},warnings:[]}}function createBootstrapStreamResult(e){let t=[{type:`stream-start`,warnings:e.warnings}];e.response!==void 0&&t.push({...e.response,type:`response-metadata`});let n=0;for(let r of e.content)switch(r.type){case`text`:{let e=`text_${n}`;n+=1,t.push({id:e,type:`text-start`}),r.text.length>0&&t.push({delta:r.text,id:e,type:`text-delta`}),t.push({id:e,type:`text-end`});break}case`tool-call`:t.push(r);break;default:break}return t.push({finishReason:e.finishReason,type:`finish`,usage:e.usage}),{stream:new ReadableStream({start(e){for(let n of t)e.enqueue(n);e.close()}})}}function estimateTokenCount(e){return Math.max(1,Math.ceil(e.trim().length/4))}function getPromptContentText(e){return typeof e==`string`?e:e.flatMap(e=>{if(typeof e==`string`)return[e];switch(e.type){case`text`:return[e.text];default:return[]}}).join(``)}function getLastUserPromptText(e){for(let t of[...e].reverse()){if(t.role!==`user`)continue;let e=getPromptContentText(t.content).trim();if(e.length>0)return e}return null}function getPromptText(e){return e.map(e=>getPromptContentText(e.content)).join(` `)}export{createBootstrapGenerateResult,createBootstrapStreamResult,estimateTokenCount,getLastUserPromptText,getPromptContentText,getPromptText};

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

@@ -0,0 +1,7 @@
+import type { LanguageModel } from "ai";
+import { type RuntimeModelReference } from "#runtime/agent/bootstrap.js";
+/**
+ * Resolves the framework-owned bootstrap model into a deterministic local
+ * language model.
+ */
+export declare function resolveBootstrapRuntimeModel(reference: RuntimeModelReference): LanguageModel | null;

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

@@ -0,0 +1 @@
+import{MockLanguageModelV3}from"ai/test";import{BOOTSTRAP_RUNTIME_MODEL_ID}from"#runtime/agent/bootstrap.js";import{createBootstrapGenerateResult,createBootstrapStreamResult,estimateTokenCount,getLastUserPromptText,getPromptText}from"#runtime/agent/bootstrap-model-utils.js";const bootstrapRuntimeModels=new Map;function resolveBootstrapRuntimeModel(n){if(n.id!==BOOTSTRAP_RUNTIME_MODEL_ID)return null;let i=bootstrapRuntimeModels.get(n.id);if(i!==void 0)return i;let a=new MockLanguageModelV3({doGenerate:async e=>createBootstrapModelResult(e.prompt,n.id),doStream:async e=>createBootstrapStreamResult(createBootstrapModelResult(e.prompt,n.id)),modelId:n.id,provider:`eve-bootstrap`});return bootstrapRuntimeModels.set(n.id,a),a}function createBootstrapModelResult(e,t){let r=`Bootstrap reply: ${getLastUserPromptText(e)??`Hello from Eve`}`;return createBootstrapGenerateResult({inputTokens:estimateTokenCount(getPromptText(e)),modelId:t,outputTokens:estimateTokenCount(r),text:r})}export{resolveBootstrapRuntimeModel};

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

@@ -0,0 +1,44 @@
+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";
+/**
+ * Fixed internal model reference used only by the framework-owned bootstrap
+ * runtime path.
+ */
+export declare const BOOTSTRAP_RUNTIME_MODEL_ID = "eve-bootstrap-model";
+/**
+ * Runtime-owned model identifier prepared for one harness turn.
+ */
+export type RuntimeModelReference = Readonly<InternalAgentModelDefinition>;
+/**
+ * Minimal runtime-owned agent shape prepared for one harness turn.
+ */
+export interface RuntimeTurnAgent {
+    readonly id: string;
+    readonly instructions: readonly string[];
+    /**
+     * Optional model used only for compaction summaries.
+     *
+     * When omitted, the harness uses the active turn model for compaction.
+     */
+    readonly compactionModel?: RuntimeModelReference;
+    readonly model: RuntimeModelReference;
+    readonly nodeId?: string;
+    readonly outputSchema?: ResolvedAgent["config"]["outputSchema"];
+    readonly tools: readonly PreparedRuntimeTool[];
+    readonly workspaceSpec: WorkspaceRuntimeSpec;
+}
+/**
+ * Static system prompt for the bootstrap runtime path.
+ */
+export declare const 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.";
+/**
+ * Creates the runtime-owned turn-preparation shape from a resolved authored
+ * agent and the authored tool descriptors prepared for the harness.
+ */
+export declare function createResolvedRuntimeTurnAgent(input: {
+    readonly agent: ResolvedAgent;
+    readonly nodeId?: string;
+    readonly tools: readonly PreparedRuntimeTool[];
+}): RuntimeTurnAgent;

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

@@ -0,0 +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(e){let t=e.agent;return{id:t.config.name,instructions:composeRuntimeBasePrompt({connections:t.connections,instructions:t.instructions,skills:t.skills,toolsAvailable:e.tools.length>0,workspaceSpec:t.workspaceSpec}),compactionModel:t.config.compaction?.model,model:t.config.model,nodeId:e.nodeId,outputSchema:t.config.outputSchema,tools:[...e.tools],workspaceSpec:t.workspaceSpec}}export{BOOTSTRAP_RUNTIME_MODEL_ID,BOOTSTRAP_RUNTIME_SYSTEM_PROMPT,createResolvedRuntimeTurnAgent};

package/dist/src/runtime/agent/mock-model-adapter.d.ts

@@ -0,0 +1,21 @@
+import type { LanguageModel } from "ai";
+import { type RuntimeModelReference } from "#runtime/agent/bootstrap.js";
+/**
+ * Environment variable that forces authored runtime models onto the dedicated
+ * deterministic mock adapter.
+ */
+export declare const EVE_MOCK_AUTHORED_MODELS_ENV = "EVE_MOCK_AUTHORED_MODELS";
+/**
+ * Returns true when authored runtime models should resolve through the
+ * dedicated deterministic mock adapter.
+ */
+export declare function shouldMockAuthoredRuntimeModels(): boolean;
+/**
+ * Creates a deterministic authored-model mock for one runtime model reference.
+ */
+export declare function createMockAuthoredRuntimeModel(reference: RuntimeModelReference): LanguageModel;
+/**
+ * Resolves the current authored runtime model onto the deterministic mock
+ * adapter when the test seam is active.
+ */
+export declare function resolveMockAuthoredRuntimeModel(reference: RuntimeModelReference): LanguageModel | null;

package/dist/src/runtime/agent/mock-model-adapter.js

@@ -0,0 +1,5 @@
+import{z}from"#compiled/zod/index.js";import{CODE_MODE_TOOL_NAME}from"#shared/code-mode.js";import{LOAD_SKILL_TOOL_NAME}from"#runtime/skills/fragment-context.js";import{FINAL_OUTPUT_TOOL_NAME}from"#runtime/framework-tools/final-output.js";import{MockLanguageModelV3}from"ai/test";import{BOOTSTRAP_RUNTIME_MODEL_ID,BOOTSTRAP_RUNTIME_SYSTEM_PROMPT}from"#runtime/agent/bootstrap.js";import{createBootstrapGenerateResult,createBootstrapStreamResult,estimateTokenCount,getLastUserPromptText,getPromptContentText,getPromptText}from"#runtime/agent/bootstrap-model-utils.js";import{findRelevantSkill,getActivatedSkillIds,getAvailableSkills}from"#runtime/agent/mock-model-skill-selection.js";import{createJsonSchemaSample}from"#runtime/agent/mock-structured-output.js";const authoredRuntimeModelMocks=new Map,bootstrapWeatherPayloadSchema=z.object({city:z.string(),condition:z.string(),summary:z.string(),temperatureF:z.number().finite()}).strict(),EVE_MOCK_AUTHORED_MODELS_ENV=`EVE_MOCK_AUTHORED_MODELS`;function shouldMockAuthoredRuntimeModels(){return process.env.EVE_MOCK_AUTHORED_MODELS===`1`||process.env.NODE_ENV===`test`}function createMockAuthoredRuntimeModel(e){let t=authoredRuntimeModelMocks.get(e.id);if(t!==void 0)return t;let n=new MockLanguageModelV3({modelId:e.id,provider:`eve-runtime-mock`,doGenerate:async t=>createMockModelResult(t,e.id),doStream:async t=>createBootstrapStreamResult(createMockModelResult(t,e.id))});return authoredRuntimeModelMocks.set(e.id,n),n}function createMockModelResult(e,t){let n=getLastAuthoredToolResult(e.prompt);if(n!==null){let r=createFollowUpToolCallResult({modelId:t,options:e,result:n});if(r!==null)return r}else{let n=createSkillLoadResult(e.prompt,t)??createAuthoredToolCallResult(e,t);if(n!==null)return n}let r=createFinalOutputResult(e,t);if(r!==null)return r;let i=n===null?createAssistantMessage(e.prompt):formatToolResultReply(n,e.prompt);return createBootstrapGenerateResult({inputTokens:estimateTokenCount(getPromptText(e.prompt)),modelId:t,outputTokens:estimateTokenCount(i),text:i})}function createFinalOutputResult(e,t){let n=getAvailableTools(e).find(e=>e.name===FINAL_OUTPUT_TOOL_NAME);if(n===void 0)return null;let i=createJsonSchemaSample(n.inputSchema);return createToolCallGenerateResult({input:i,inputTokens:estimateTokenCount(getPromptText(e.prompt)),modelId:t,outputTokens:estimateTokenCount(JSON.stringify(i)),toolCallId:createToolCallId(FINAL_OUTPUT_TOOL_NAME),toolName:FINAL_OUTPUT_TOOL_NAME})}function resolveMockAuthoredRuntimeModel(e){return!shouldMockAuthoredRuntimeModels()||e.id===BOOTSTRAP_RUNTIME_MODEL_ID?null:createMockAuthoredRuntimeModel(e)}function createSkillLoadResult(e,t){let r=getLastUserPromptText(e);if(r===null||getActivatedSkillIds(e).length>0)return null;let i=findRelevantSkill(getAvailableSkills(e),r);return i===null?null:createToolCallGenerateResult({input:{skill:i.name},inputTokens:estimateTokenCount(getPromptText(e)),modelId:t,outputTokens:estimateTokenCount(i.name),toolCallId:`call_load_skill`,toolName:LOAD_SKILL_TOOL_NAME})}function createAuthoredToolCallResult(e,n){let r=getLastUserPromptText(e.prompt);if(r===null)return null;let i=findRelevantTool(getAvailableTools(e),r);if(i===null)return null;let a=resolveWeatherCity(r),o=createAuthoredToolInput(i,r,a);if(i.name===CODE_MODE_TOOL_NAME){let t=findRelevantCodeModeHostTool(i.description,r);if(t===null)return null;let o=`return await tools${formatCodeModeToolAccess(t)}({ city: ${JSON.stringify(a)} });`;return createToolCallGenerateResult({input:{js:o},inputTokens:estimateTokenCount(getPromptText(e.prompt)),modelId:n,outputTokens:estimateTokenCount(o),toolCallId:createToolCallId(i.name),toolName:i.name})}return createToolCallGenerateResult({input:o,inputTokens:estimateTokenCount(getPromptText(e.prompt)),modelId:n,outputTokens:estimateTokenCount(Object.values(o).join(` `)),toolCallId:createToolCallId(i.name),toolName:i.name})}function createFollowUpToolCallResult(e){let t=findNextExplicitToolAfterResult({previousToolName:e.result.toolName,prompt:e.options.prompt,tools:getAvailableTools(e.options)});if(t===null)return null;let n=createFollowUpToolInput(e.result.output);return n===null?null:createToolCallGenerateResult({input:n,inputTokens:estimateTokenCount(getPromptText(e.options.prompt)),modelId:e.modelId,outputTokens:estimateTokenCount(Object.values(n).join(` `)),toolCallId:createToolCallId(t.name),toolName:t.name})}function createAuthoredToolInput(e,t,n){let r=getToolInputPropertyNames(e.inputSchema);return r.includes(`topic`)||/\btopic\b/u.test(normalizeText(t))?{topic:resolveLookupTopic(t)}:r.length===1&&r[0]===`message`?{message:t}:{city:n}}function createAssistantMessage(e){let t=getLastUserPromptText(e)??`Hello from Eve`,n=getSystemPromptLabels(e),r=resolveSystemProbe(e);return n.length>0?r===null?`Bootstrap reply [${n.join(`, `)}]: ${t}`:`Bootstrap reply [${n.join(`, `)}; probe=${r}]: ${t}`:r===null?`Bootstrap reply: ${t}`:`Bootstrap reply [probe=${r}]: ${t}`}function formatToolResultReply(e,t){if(e.isError)return`Local weather tool failed: ${formatToolOutput(e.output)}`;if(isWeatherPayload(e.output))return`Used local weather tool for ${e.output.city}: ${e.output.condition}, ${e.output.temperatureF}F. ${e.output.summary}`;let n=getLastUserPromptText(t)??`Hello from Eve`;return`Used ${e.toolName} for "${n}": ${formatToolOutput(e.output)}`}function createToolCallGenerateResult(e){return{content:[{input:JSON.stringify(e.input),toolCallId:e.toolCallId,toolName:e.toolName,type:`tool-call`}],finishReason:{raw:void 0,unified:`tool-calls`},response:{id:`bootstrap-response`,modelId:e.modelId,timestamp:new Date(`2026-03-16T00:00:00.000Z`)},usage:{inputTokens:{cacheRead:0,cacheWrite:0,noCache:e.inputTokens,total:e.inputTokens},outputTokens:{reasoning:0,text:e.outputTokens,total:e.outputTokens}},warnings:[]}}function getAvailableTools(e){return(e.tools??[]).flatMap(e=>e.type===`function`?[{description:e.description,inputSchema:`inputSchema`in e?e.inputSchema:void 0,name:e.name,outputSchema:`outputSchema`in e?e.outputSchema:void 0}]:[])}function getLastAuthoredToolResult(e){for(let t of[...e].reverse()){if(t.role===`user`)return null;if(!(t.role!==`tool`&&t.role!==`assistant`)){for(let e of[...t.content].reverse())if(!(typeof e==`string`||e.type!==`tool-result`)&&e.toolName!==LOAD_SKILL_TOOL_NAME)return{isError:e.output.type===`error-json`||e.output.type===`error-text`||e.output.type===`execution-denied`,output:e.output.type===`execution-denied`?{reason:e.output.reason??null,type:e.output.type}:e.output.value,toolCallId:e.toolCallId,toolName:e.toolName}}}return null}function findNextExplicitToolAfterResult(e){let t=getLastUserPromptText(e.prompt);if(t===null)return null;let n=normalizeText(t),r=n.indexOf(normalizeText(e.previousToolName));return r<0?null:e.tools.filter(t=>t.name!==e.previousToolName).flatMap(e=>{let t=n.indexOf(normalizeText(e.name),r+1);return t<0?[]:[{index:t,tool:e}]}).sort((e,t)=>e.index-t.index)[0]?.tool??null}function createFollowUpToolInput(e){return isRecord(e)&&typeof e.stepKey==`string`?{stepKey:e.stepKey}:null}function getSystemPromptLabels(e){let t=e.filter(e=>e.role===`system`);if(t.length===0)return[];let n=t.flatMap(e=>{let t=getPromptContentText(e.content);if(t.startsWith(`Available skills
+`))return[];let n=t.split(`
+`).map(e=>e.trim()).filter(e=>e.length>0),r=[];for(let e of n){if(e===BOOTSTRAP_RUNTIME_SYSTEM_PROMPT||e===`Available skills`)continue;let t=/^System \((.+)\)$/.exec(e);if(t?.[1]){r.push(t[1]);continue}let n=/^Skill \((.+)\)$/.exec(e);n?.[1]&&r.push(n[1])}if(r.length>0)return r;let i=n.find(e=>e!==BOOTSTRAP_RUNTIME_SYSTEM_PROMPT&&e!==`Available skills`);return i===void 0?[]:[i]});return[...new Set(n)]}function getToolInputPropertyNames(e){return!isRecord(e)||!isRecord(e.properties)?[]:Object.keys(e.properties)}function findRelevantTool(e,t){let n=normalizeText(t),r=e.find(e=>e.name!==`agent`&&n.includes(normalizeText(e.name)));return r===void 0?/\b(forecast|temperature|weather|wind|rain|snow)\b/u.test(n)?e.find(e=>/\b(forecast|temperature|weather|wind|rain|snow)\b/u.test(normalizeText(`${e.name} ${e.description??``}`)))??null:null:r}function findRelevantCodeModeHostTool(e,t){return e===void 0?null:findRelevantTool(parseCodeModeHostTools(e),t)?.name??null}function parseCodeModeHostTools(e){let t=[],n;for(let r of e.split(`
+`)){let e=/^\s*\/\*\*\s*(.*?)\s*\*\/\s*$/u.exec(r);if(e?.[1]!==void 0){n=e[1];continue}let i=/^\s*(?:([$A-Z_a-z][$\w]*)|(["'])(.*?)\2)\s*:\s*\(input:/u.exec(r),a=i?.[1]??i?.[3];a!==void 0&&(t.push({description:n,name:a}),n=void 0)}return t}function formatCodeModeToolAccess(e){return/^[$A-Z_a-z][$\w]*$/u.test(e)?`.${e}`:`[${JSON.stringify(e)}]`}function normalizeText(e){return e.toLowerCase().replace(/[^a-z0-9]+/gu,` `).trim()}function createToolCallId(e){return`call_${e.toLowerCase().replace(/[^a-z0-9]+/gu,`_`).replace(/^_+|_+$/gu,``)||`tool`}`}function resolveSystemProbe(e){let t=e.filter(e=>e.role===`system`).map(e=>getPromptContentText(e.content)).join(`
+`);return/hmr-probe:\s*([^\n]+)/iu.exec(t)?.[1]?.trim()||null}function resolveWeatherCity(e){let t=/"city"\s*:\s*"([^"]+)"/u.exec(e);return t?.[1]?t[1].trim():(/\b(?:in|for)\s+([A-Za-z][A-Za-z\s.-]*?)(?:[?.!,]|$)/u.exec(e)??/\b([A-Z][a-z]+(?:\s+[A-Z][a-z]+)*)\b/u.exec(e))?.[1]?.trim()||`Brooklyn`}function resolveLookupTopic(e){return/\btopic\s+['"]?([A-Za-z0-9_.-]+)['"]?/u.exec(e)?.[1]??`demo`}function isWeatherPayload(e){return bootstrapWeatherPayloadSchema.safeParse(e).success}function isRecord(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function formatToolOutput(e){if(typeof e==`string`)return e;try{return JSON.stringify(e)}catch{return String(e)}}export{EVE_MOCK_AUTHORED_MODELS_ENV,createMockAuthoredRuntimeModel,resolveMockAuthoredRuntimeModel,shouldMockAuthoredRuntimeModels};

package/dist/src/runtime/agent/mock-model-skill-selection.d.ts

@@ -0,0 +1,9 @@
+import type { BootstrapPrompt } from "#runtime/agent/bootstrap-model-utils.js";
+interface AvailableBootstrapSkill {
+    readonly description: string;
+    readonly name: string;
+}
+export declare function getAvailableSkills(prompt: BootstrapPrompt): AvailableBootstrapSkill[];
+export declare function findRelevantSkill(skills: readonly AvailableBootstrapSkill[], message: string): AvailableBootstrapSkill | null;
+export declare function getActivatedSkillIds(prompt: BootstrapPrompt): string[];
+export {};

package/dist/src/runtime/agent/mock-model-skill-selection.js

@@ -0,0 +1,4 @@
+import{getPromptContentText}from"#runtime/agent/bootstrap-model-utils.js";function getAvailableSkills(t){let n=new Map;for(let r of t){if(r.role!==`system`)continue;let t=getPromptContentText(r.content);if(t.startsWith(`Available skills
+`))for(let e of t.split(`
+`).slice(1)){let t=parseAvailableSkill(e);t!==null&&n.set(t.name,t)}}return[...n.values()]}function findRelevantSkill(e,t){let n=normalizeText(t);for(let t of e)if(n.includes(normalizeText(t.name)))return t;return/\b(forecast|temperature|weather|wind|rain|snow)\b/u.test(n)?e.find(e=>/\b(forecast|temperature|weather|wind|rain|snow)\b/u.test(normalizeText(`${e.name} ${e.description}`)))??null:null}function getActivatedSkillIds(t){return t.filter(e=>e.role===`system`).flatMap(t=>getPromptContentText(t.content).split(`
+`).map(e=>e.trim()).flatMap(e=>{let t=/^Skill \((.+)\)$/.exec(e);return t?.[1]===void 0?[]:[t[1]]}))}function parseAvailableSkill(e){let t=/^- (.+?): (.+?)(?: \(path: (.+)\))?$/.exec(e.trim());return t?.[1]&&t[2]?{description:t[2],name:t[1]}:null}function normalizeText(e){return e.toLowerCase().replace(/[^a-z0-9]+/gu,` `).trim()}export{findRelevantSkill,getActivatedSkillIds,getAvailableSkills};

package/dist/src/runtime/agent/mock-structured-output.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Builds a deterministic sample value satisfying a JSON Schema, used by the
+ * mock model to populate a `final_output` tool call in tests.
+ */
+export declare function createJsonSchemaSample(schema: unknown): unknown;

package/dist/src/runtime/agent/mock-structured-output.js

@@ -0,0 +1 @@
+function createJsonSchemaSample(e){if(!isRecord(e))return{};if(`const`in e)return e.const;if(Array.isArray(e.enum)&&e.enum.length>0)return e.enum[0];let t=getFirstSchema(e.oneOf)??getFirstSchema(e.anyOf);if(t!==void 0)return createJsonSchemaSample(t);switch(getJsonSchemaType(e)){case`array`:return[createJsonSchemaSample(getFirstSchema(e.items)??e.items)];case`boolean`:return!0;case`integer`:case`number`:return 1;case`null`:return null;case`object`:return createJsonSchemaObjectSample(e);case`string`:return createJsonSchemaStringSample(e);default:return isRecord(e.properties)?createJsonSchemaObjectSample(e):e.items===void 0?{}:[createJsonSchemaSample(getFirstSchema(e.items)??e.items)]}}function createJsonSchemaObjectSample(e){let t=isRecord(e.properties)?e.properties:{},n=Array.isArray(e.required)?e.required.filter(e=>typeof e==`string`):[],r=new Set([...n,...Object.keys(t)]),i={};for(let e of r)i[e]=createJsonSchemaSample(t[e]);return i}function createJsonSchemaStringSample(e){switch(e.format){case`date`:return`2026-01-01`;case`date-time`:return`2026-01-01T00:00:00.000Z`;case`email`:return`eve@example.com`;case`uri`:return`https://example.com`;default:return`structured-output`}}function getJsonSchemaType(e){if(typeof e.type==`string`)return e.type;if(Array.isArray(e.type))return e.type.find(e=>typeof e==`string`&&e!==`null`)}function getFirstSchema(e){return Array.isArray(e)?e[0]:e}function isRecord(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}export{createJsonSchemaSample};

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

@@ -0,0 +1,11 @@
+import type { LanguageModel } from "ai";
+import type { RuntimeCompiledArtifactsSource } from "#runtime/compiled-artifacts-source.js";
+import type { RuntimeModelReference } from "#runtime/agent/bootstrap.js";
+import { EVE_MOCK_AUTHORED_MODELS_ENV, shouldMockAuthoredRuntimeModels } from "#runtime/agent/mock-model-adapter.js";
+export { EVE_MOCK_AUTHORED_MODELS_ENV, shouldMockAuthoredRuntimeModels };
+/**
+ * Resolves one runtime model reference into the active language model.
+ */
+export declare function resolveRuntimeModelReference(reference: RuntimeModelReference, input?: {
+    readonly compiledArtifactsSource?: RuntimeCompiledArtifactsSource;
+}): Promise<LanguageModel>;

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

@@ -0,0 +1 @@
+import{expectObjectRecord,getAuthoredModuleExport,materializeAuthoredModuleExport}from"#internal/authored-module.js";import{ROOT_COMPILED_AGENT_NODE_ID}from"#compiler/manifest.js";import{normalizeAgentDefinition}from"#internal/authored-definition/core.js";import{loadCompiledModuleMap}from"#runtime/loaders/module-map.js";import{resolveBootstrapRuntimeModel}from"#runtime/agent/bootstrap-model.js";import{EVE_MOCK_AUTHORED_MODELS_ENV,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(i,a){if(a.compiledArtifactsSource===void 0)throw Error(`Expected an explicit compiled artifact source to resolve the authored runtime model "${i.id}".`);let o=(await loadCompiledModuleMap({compiledArtifactsSource:a.compiledArtifactsSource})).nodes[ROOT_COMPILED_AGENT_NODE_ID]?.modules[i.source.sourceId],s=normalizeAgentDefinition(await materializeAuthoredModuleExport(getAuthoredModuleExport(expectObjectRecord(o,`Missing compiled agent config module for runtime model "${i.id}" at "${i.source.logicalPath}".`),i.source)),`Expected the authored agent config export "${i.source.exportName??`default`}" from "${i.source.logicalPath}" to match the public Eve shape.`).model;if(s===void 0)throw Error(`Expected the authored agent config export "${i.source.exportName??`default`}" from "${i.source.logicalPath}" to provide a runtime model.`);return s}function isSourceBackedRuntimeModelReference(e){return e.source!==void 0}export{EVE_MOCK_AUTHORED_MODELS_ENV,resolveRuntimeModelReference,shouldMockAuthoredRuntimeModels};

package/dist/src/runtime/attributes/emit.d.ts

@@ -0,0 +1,73 @@
+import "#internal/workflow/builtins.js";
+/**
+ * Maximum byte size for an attribute value on a workflow run.
+ *
+ * Local mirror of `ATTRIBUTE_VALUE_MAX_BYTES` from `@workflow/world`
+ * (source of truth: `packages/world/src/attributes.ts` in the workflow
+ * repo). The value is duplicated rather than imported because
+ * `@workflow/core` — the only workflow surface bundled into the
+ * workflow body — does not re-export it, and pulling `@workflow/world`
+ * into the body bundle would drag in the full zod attribute validator
+ * (the same reason `workflow-core-shim.ts` skips runtime validation in
+ * its `experimental_setAttributes`).
+ *
+ * Strings emitted through {@link setEveAttributes} are truncated to this
+ * byte count before they reach the runtime so the validator never
+ * rejects a tag for length alone.
+ *
+ * Drift is conservative-by-construction: if workflow LOWERS the limit,
+ * over-long values are rejected and `setEveAttributes` swallows the
+ * failure (warn-once-per-process) — dashboards see a missing tag, never
+ * a broken agent; if workflow RAISES it, titles are merely shorter than
+ * necessary. `emit.drift.test.ts` asserts equality against the real
+ * `@workflow/world` export (a devDependency) so CI fails loudly the day
+ * the constants diverge.
+ */
+export declare const EVE_ATTRIBUTE_VALUE_MAX_BYTES = 256;
+/**
+ * Attribute value the caller wants to write. `undefined` values are
+ * stripped before the runtime call; numbers are stringified; strings
+ * are truncated to {@link EVE_ATTRIBUTE_VALUE_MAX_BYTES}.
+ */
+export type EveAttributeValue = string | number | undefined;
+/**
+ * Truncates a string so its UTF-8 byte length is at most `maxBytes`
+ * without splitting a multi-byte character.
+ *
+ * The workflow runtime measures attribute values in UTF-8 bytes, not
+ * code units, so `value.slice(0, maxBytes)` is not safe — a JS string
+ * with two-byte characters (e.g. emoji surrogate pairs) can serialize
+ * to twice as many bytes as code units. We re-encode the truncated
+ * candidate after each drop and shrink one code unit at a time when
+ * the candidate's last character straddles the byte budget.
+ */
+export declare function truncateForTag(value: string, maxBytes?: number): string;
+/**
+ * Writes a batch of Eve-owned attributes to the active workflow run.
+ *
+ * Reserved-namespace contract:
+ * - All keys must use the `$eve.` prefix (the workflow runtime would
+ *   otherwise reject them as user-space writes into the reserved `$`
+ *   namespace).
+ * - The call always opts in via `{ allowReservedAttributes: true }`
+ *   on behalf of the framework — authored code never calls this helper
+ *   directly.
+ *
+ * Value normalization:
+ * - `undefined` entries are dropped so callers can build attribute
+ *   maps with optional fields (`$eve.subagent` is only present on
+ *   subagent roots, for example).
+ * - Numbers are stringified (the runtime stores all values as strings).
+ * - Strings are truncated to {@link EVE_ATTRIBUTE_VALUE_MAX_BYTES} via
+ *   {@link truncateForTag} so a long free-form value (e.g. `$eve.title`)
+ *   can never trip the runtime's per-value byte budget.
+ *
+ * Failure policy: tag writes are observability metadata, not load-bearing
+ * state. A failure inside the runtime (transient network, schema bug,
+ * missing world adapter) is logged once per process and then swallowed
+ * so the Eve session it tagged is unaffected.
+ *
+ * Must be called from inside a `"use workflow"` or `"use step"` body —
+ * the runtime throws a `FatalError` outside those contexts.
+ */
+export declare function setEveAttributes(attrs: Record<string, EveAttributeValue>): Promise<void>;

package/dist/src/runtime/attributes/emit.js

@@ -0,0 +1 @@
+import"#internal/workflow/builtins.js";const EVE_ATTRIBUTE_VALUE_MAX_BYTES=256;let WARNED_ABOUT_TAG_FAILURE=!1;function truncateForTag(e,t=256){if(t<=0)return``;let n=new TextEncoder;if(n.encode(e).length<=t)return e;let r=e.length;for(;r>0;){let i=e.charCodeAt(r-1);if(i>=55296&&i<=56319){--r;continue}let a=e.slice(0,r);if(n.encode(a).length<=t)return a;--r}return``}async function setEveAttributes(e){let n={};for(let[t,r]of Object.entries(e))r!==void 0&&(n[t]=truncateForTag(typeof r==`number`?String(r):r));if(Object.keys(n).length!==0)try{let{experimental_setAttributes:e}=await import(`#compiled/@workflow/core/index.js`);await e(n,{allowReservedAttributes:!0})}catch(e){WARNED_ABOUT_TAG_FAILURE||(WARNED_ABOUT_TAG_FAILURE=!0,console.warn(`[eve] setEveAttributes failed; suppressing further warnings this process.`,{keys:Object.keys(n),error:e.message}))}}export{EVE_ATTRIBUTE_VALUE_MAX_BYTES,setEveAttributes,truncateForTag};

package/dist/src/runtime/cache-key.d.ts

@@ -0,0 +1,9 @@
+import { type RuntimeCompiledArtifactsSource } from "#runtime/compiled-artifacts-source.js";
+/**
+ * Resolves a cache key for one compiled-artifact source that also fingerprints
+ * the current compiled source graph when metadata is available.
+ *
+ * This lets long-lived processes keep cache hits across turns while still
+ * invalidating naturally after recompilation under the same app root.
+ */
+export declare function resolveRuntimeCompiledArtifactsVersionedCacheKey(source: RuntimeCompiledArtifactsSource): Promise<string>;

package/dist/src/runtime/cache-key.js

@@ -0,0 +1 @@
+import{getRuntimeCompiledArtifactsCacheKey}from"#runtime/compiled-artifacts-source.js";import{loadCompileMetadata}from"#runtime/loaders/compile-metadata.js";import{resolveRuntimeCompilerArtifactPaths}from"#runtime/loaders/artifact-paths.js";async function resolveRuntimeCompiledArtifactsVersionedCacheKey(n){let r=getRuntimeCompiledArtifactsCacheKey(n),i=await resolveCompileMetadataMtimeMs(n);try{let e=(await loadCompileMetadata({compiledArtifactsSource:n}))?.discovery.sourceGraphHash;return e===void 0||e.length===0?i===void 0?r:`${r}:mtime-${formatMtimeMsForCacheKey(i)}`:i===void 0?`${r}:${e}`:`${r}:${e}:mtime-${formatMtimeMsForCacheKey(i)}`}catch{return i===void 0?r:`${r}:mtime-${formatMtimeMsForCacheKey(i)}`}}async function resolveCompileMetadataMtimeMs(e){if(e.kind!==`disk`)return;let{stat:t}=await import(`node:fs/promises`),{compileMetadataPath:r}=resolveRuntimeCompilerArtifactPaths(e.appRoot);try{return(await t(r)).mtimeMs}catch{return}}function formatMtimeMsForCacheKey(e){return Math.floor(e).toString(36)}export{resolveRuntimeCompiledArtifactsVersionedCacheKey};

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

@@ -0,0 +1,27 @@
+import type { ChannelAdapter } from "#channel/adapter.js";
+import type { ResolvedChannelDefinition } from "#runtime/types.js";
+/**
+ * Runtime-owned registry of adapter configs keyed by adapter kind.
+ * Used to rebuild adapter instances (with behavior functions) after
+ * workflow step boundaries.
+ */
+export interface RuntimeAdapterRegistry {
+    readonly adaptersByKind: ReadonlyMap<string, ChannelAdapter>;
+}
+/**
+ * Builds the runtime-owned adapter registry from framework adapters plus any
+ * custom adapters declared on resolved route definitions.
+ *
+ * Route-declared adapters may share framework kinds only as pass-throughs.
+ */
+export declare function createRuntimeAdapterRegistry(input: {
+    readonly channels: readonly ResolvedChannelDefinition[];
+}): RuntimeAdapterRegistry;
+/**
+ * Rehydrates one serialized adapter from the runtime-owned registry.
+ *
+ * Looks up the adapter config by `kind`, then merges the serialized state
+ * onto it. The result is a full adapter with behavior functions and
+ * restored state.
+ */
+export declare function deserializeRuntimeAdapter(registry: RuntimeAdapterRegistry, data: unknown): ChannelAdapter;

package/dist/src/runtime/channels/registry.js

@@ -0,0 +1 @@
+import{getAdapterKind}from"#channel/adapter.js";import{SUBAGENT_ADAPTER}from"#execution/subagent-adapter.js";import{SCHEDULE_ADAPTER}from"#channel/schedule.js";import{HTTP_ADAPTER}from"#channel/http.js";import{RuntimeRegistryError}from"#internal/runtime-registry.js";const FRAMEWORK_ADAPTERS=[HTTP_ADAPTER,SUBAGENT_ADAPTER,SCHEDULE_ADAPTER],ADAPTER_NON_EVENT_FIELDS=new Set([`kind`,`state`,`deliver`,`createAdapterContext`,`fetchFile`,`instrumentation`]);function createRuntimeAdapterRegistry(e){let t=new Map,n=new Set;for(let e of FRAMEWORK_ADAPTERS){let r=requireAdapterKind(e);n.add(r),t.set(r,e)}for(let r of e.channels){if(r.adapter===void 0)continue;let e={logicalPath:r.logicalPath,sourceId:r.sourceId},i=r.adapter,a=requireAdapterKind(i,e);if(n.has(a)){if(carriesAdapterBehavior(i))throw new RuntimeRegistryError(`adapter`,`Channel adapter kind "${a}" is reserved by the framework. A route-declared adapter may share a framework kind only as a pass-through with no \`deliver\` hook, event handlers, \`attachments\` resolver, or \`createAdapterContext\` factory. Use a custom \`kind\` to add channel-specific behavior.`,{...e,entryName:a});continue}t.set(a,i)}return{adaptersByKind:t}}function deserializeRuntimeAdapter(e,t){let n=t,r=e.adaptersByKind.get(n.kind);if(r===void 0)throw Error(`Unknown adapter kind: "${n.kind}". Declare the adapter on the route that starts this session so the runtime can rehydrate it.`);return{...r,state:n.state}}function requireAdapterKind(t,n){let r=getAdapterKind(t);if(typeof r!=`string`||r.length===0)throw new RuntimeRegistryError(`adapter`,"Adapters must declare a non-empty `kind` field.",{entryName:`unknown`,logicalPath:n?.logicalPath,sourceId:n?.sourceId});return r}function carriesAdapterBehavior(e){if(e.deliver!==void 0||e.fetchFile!==void 0||e.createAdapterContext!==void 0)return!0;for(let[t,n]of Object.entries(e))if(!ADAPTER_NON_EVENT_FIELDS.has(t)&&typeof n==`function`)return!0;return!1}export{createRuntimeAdapterRegistry,deserializeRuntimeAdapter};

package/dist/src/runtime/compiled-artifacts-source.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Runtime-owned compiled-artifact source for one resolved agent graph.
+ */
+export type RuntimeCompiledArtifactsSource = RuntimeBundledCompiledArtifactsSource | RuntimeDiskCompiledArtifactsSource;
+/**
+ * Bundled compiled artifacts installed in-process beside runtime workflow
+ * entrypoints.
+ */
+export interface RuntimeBundledCompiledArtifactsSource {
+    readonly kind: "bundled";
+}
+/**
+ * Disk-backed compiled artifacts rooted at one authored application.
+ */
+export interface RuntimeDiskCompiledArtifactsSource {
+    readonly appRoot: string;
+    readonly kind: "disk";
+    /**
+     * Native filesystem path to the package-owned authored-source module map
+     * loader. When set, the runtime loads modules directly from authored
+     * source instead of the bundled-compiled module map. Omitted in deployed
+     * runtimes, where the module map must come from the compiled artifact
+     * emitted by the build.
+     */
+    readonly moduleMapLoaderPath?: string;
+}
+/**
+ * Creates the bundled compiled-artifact source.
+ */
+export declare function createBundledRuntimeCompiledArtifactsSource(): RuntimeBundledCompiledArtifactsSource;
+/**
+ * Creates the disk-backed compiled-artifact source for one authored app root.
+ */
+export declare function createDiskRuntimeCompiledArtifactsSource(appRoot: string, options?: {
+    readonly moduleMapLoaderPath?: string;
+}): RuntimeDiskCompiledArtifactsSource;
+/**
+ * Returns the disk-backed app root when one exists for the artifact source.
+ */
+export declare function getRuntimeCompiledArtifactsAppRoot(source: RuntimeCompiledArtifactsSource): string | undefined;
+/**
+ * Returns the stable cache key for one runtime artifact source.
+ */
+export declare function getRuntimeCompiledArtifactsCacheKey(source: RuntimeCompiledArtifactsSource): string;