@fevex/core 0.1.0-alpha.3 → 0.1.0-alpha.4

package/README.md

@@ -961,3 +961,19 @@ controls progress, so a slow consumer retains at most one page plus the stream's
 single queued frame, rather than buffering the run's entire history. Disconnecting
 cancels polling. This bounds event counts, not the byte size of an individual event;
 per-event payload limits and data retention remain host responsibilities.
+
+### Run model identity
+
+Agent runs retain the effective `modelName` and a `modelMetadata` snapshot when
+the gateway supplies metadata. Traces and cost calculators use this identity,
+including per-request model overrides, after terminal checkpoint cleanup and
+across pause/resume. These fields are optional for older stored runs; resuming
+an older run fills them from its checkpoint's resolved model.
+
+### Local sandbox limits
+
+The local development sandbox sends `SIGTERM` on timeout or cancellation, then
+`SIGKILL` after 100 ms if the process has not closed. Cancellation rejects with
+the caller's reason after process cleanup. Output limits apply separately to
+stdout and stderr in UTF-8 bytes, omitting an incomplete trailing character.
+This subprocess control does not provide operating-system isolation.

package/dist/agents/index.d.mts

@@ -1,2 +1,2 @@
-import { n as AgentLimits, r as defineAgent, t as AgentDefinition } from "../index-Dx_LotWZ.mjs";
+import { n as AgentLimits, r as defineAgent, t as AgentDefinition } from "../index-CaE864Kz.mjs";
 export { AgentDefinition, AgentLimits, defineAgent };

package/dist/channels/index.d.mts

@@ -1,2 +1,2 @@
-import { a as ChannelEvent, c as ChannelMessage, d as ChannelRunOptions, f as ChannelRunResult, i as ChannelError, l as ChannelOutput, n as ChannelAdapter, o as ChannelEventType, r as ChannelContext, s as ChannelFailurePhase, t as handleChannelInput, u as ChannelRunEvent } from "../index-Bgcxgy66.mjs";
-export { ChannelAdapter, ChannelContext, ChannelError, ChannelEvent, ChannelEventType, ChannelFailurePhase, ChannelMessage, ChannelOutput, ChannelRunEvent, ChannelRunOptions, ChannelRunResult, handleChannelInput };
+import { a as ChannelDeliveryOptions, c as ChannelEvent, d as ChannelMessage, f as ChannelOutput, h as ChannelRunResult, i as ChannelContext, l as ChannelEventType, m as ChannelRunOptions, n as handleChannelInput, o as ChannelElicitationContext, p as ChannelRunEvent, r as ChannelAdapter, s as ChannelError, t as deliverChannelRun, u as ChannelFailurePhase } from "../index-DyyNLuwO.mjs";
+export { ChannelAdapter, ChannelContext, ChannelDeliveryOptions, ChannelElicitationContext, ChannelError, ChannelEvent, ChannelEventType, ChannelFailurePhase, ChannelMessage, ChannelOutput, ChannelRunEvent, ChannelRunOptions, ChannelRunResult, deliverChannelRun, handleChannelInput };

package/dist/channels/index.mjs

@@ -1,17 +1,20 @@
+import { n as RunPausedError } from "../run-error-Cr17wPGH.mjs";
 //#region src/channels/channel.ts
 var ChannelError = class extends Error {
 	code;
 	safeMessage;
 	name = "ChannelError";
+	runId;
 	constructor(code, safeMessage, options) {
 		super(safeMessage, options);
 		this.code = code;
 		this.safeMessage = safeMessage;
+		this.runId = options?.runId;
 	}
 };
 //#endregion
 //#region src/channels/handle-channel-input.ts
-/** Parses one channel input, runs the configured agent, and delivers its output. */
+/** Parses one channel input, runs the configured agent, and delivers its result or elicitation. */
 async function handleChannelInput(input, options) {
 	const channelEvents = [];
 	const emit = (event) => {
@@ -32,57 +35,92 @@ async function handleChannelInput(input, options) {
 	};
 	const message = parsed;
 	emit(received(options.adapter.name, message));
-	let result;
+	let runId;
 	try {
 		const sessionId = await options.resolveSessionId?.(message);
-		result = await options.fevex.runAgent(options.agentName, {
+		runId = (await options.fevex.runAgent(options.agentName, {
 			input: message.content,
 			...sessionId ? { sessionId } : {},
 			context: channelContext(options.adapter.name, message),
 			signal: options.signal
-		});
+		})).runId;
 	} catch (cause) {
-		const error = channelError("CHANNEL_RUN_FAILED", "Channel run failed", cause);
-		emit(failed(options.adapter.name, "run", error, message));
-		throw error;
+		if (cause instanceof RunPausedError && cause.pause.type === "elicitation") runId = cause.runId;
+		else {
+			const error = channelError("CHANNEL_RUN_FAILED", "Channel run failed", cause);
+			emit(failed(options.adapter.name, "run", error, message));
+			throw error;
+		}
 	}
-	const run = await options.fevex.getRun(result.runId);
-	if (!run || run.kind === "workflow" || run.kind === "team") {
-		const error = channelError("CHANNEL_RUN_FAILED", "Channel run was not found after completion");
-		emit(failed(options.adapter.name, "run", error, message));
+	const delivered = await deliverChannelRun(runId, message, options);
+	return {
+		...delivered,
+		events: [channelEvents[0], ...delivered.events]
+	};
+}
+/** Delivers a stored agent result or elicitation without executing the agent again. */
+async function deliverChannelRun(runId, message, options) {
+	options.signal?.throwIfAborted();
+	const run = await options.fevex.getRun(runId);
+	const elicitation = run?.status === "paused" && run.pause?.type === "elicitation" ? run.pause.request : void 0;
+	if (!run || run.kind === "workflow" || run.kind === "team" || run.status !== "completed" && !elicitation) {
+		const error = channelError("CHANNEL_RUN_FAILED", "Channel run is not ready for delivery", void 0, runId);
+		options.onEvent?.(failed(options.adapter.name, "run", error, message));
 		throw error;
 	}
 	const output = {
-		deliveryId: message.deliveryId,
+		deliveryId: elicitation ? `elicitation:${runId}:${elicitation.id}` : message.deliveryId,
 		conversationId: message.conversationId,
 		...message.threadId ? { threadId: message.threadId } : {},
-		content: stringifyOutput(result.output),
+		content: elicitation ? elicitation.prompt : stringifyOutput(run.output ?? null),
 		metadata: {
-			runId: result.runId,
-			sessionId: result.sessionId
+			runId,
+			sessionId: run.sessionId,
+			...elicitation ? { requestId: elicitation.id } : {}
 		}
 	};
 	let delivery;
 	try {
-		delivery = await options.adapter.deliver(output, { signal: options.signal });
+		if (elicitation) {
+			if (!options.adapter.deliverElicitation) throw channelError("CHANNEL_ELICITATION_UNSUPPORTED", "Channel does not support elicitation delivery", void 0, runId);
+			if (elicitation.expiresAt && Date.now() > Date.parse(elicitation.expiresAt)) throw channelError("CHANNEL_ELICITATION_EXPIRED", "Channel elicitation has expired", void 0, runId);
+			delivery = await options.adapter.deliverElicitation(elicitation, {
+				signal: options.signal,
+				deliveryId: output.deliveryId,
+				runId,
+				sessionId: run.sessionId,
+				conversationId: message.conversationId,
+				...message.threadId ? { threadId: message.threadId } : {}
+			});
+		} else delivery = await options.adapter.deliver(output, { signal: options.signal });
 	} catch (cause) {
-		const error = channelError("CHANNEL_DELIVERY_FAILED", "Channel delivery failed", cause);
-		emit(failed(options.adapter.name, "deliver", error, message));
+		const error = cause instanceof ChannelError ? channelError(cause.code, cause.safeMessage, cause, runId) : channelError("CHANNEL_DELIVERY_FAILED", "Channel delivery failed", cause, runId);
+		options.onEvent?.({
+			...failed(options.adapter.name, "deliver", error, {
+				...message,
+				deliveryId: output.deliveryId
+			}),
+			...elicitation ? { requestId: elicitation.id } : {}
+		});
 		throw error;
 	}
-	const deliveredEvent = delivered(options.adapter.name, message);
-	emit(deliveredEvent);
+	const deliveredEvent = {
+		...delivered(options.adapter.name, {
+			...message,
+			deliveryId: output.deliveryId
+		}),
+		runId,
+		...elicitation ? { requestId: elicitation.id } : {}
+	};
+	options.onEvent?.(deliveredEvent);
 	return {
 		ignored: false,
 		message,
 		run,
 		output,
 		delivery,
-		events: [
-			channelEvents[0],
-			...result.events ?? [],
-			deliveredEvent
-		]
+		...elicitation ? { elicitation } : {},
+		events: [...await options.fevex.listEvents(runId), deliveredEvent]
 	};
 }
 function channelContext(adapter, message) {
@@ -132,6 +170,7 @@ function failed(adapter, phase, error, message) {
 		adapter,
 		phase,
 		error: error.safeMessage,
+		...error.runId ? { runId: error.runId } : {},
 		...message ? {
 			messageId: message.id,
 			deliveryId: message.deliveryId,
@@ -140,11 +179,14 @@ function failed(adapter, phase, error, message) {
 		} : {}
 	};
 }
-function channelError(code, safeMessage, cause) {
-	return new ChannelError(code, safeMessage, cause === void 0 ? void 0 : { cause });
+function channelError(code, safeMessage, cause, runId) {
+	return new ChannelError(code, safeMessage, {
+		...cause === void 0 ? {} : { cause },
+		...runId ? { runId } : {}
+	});
 }
 function stringifyOutput(value) {
 	return typeof value === "string" ? value : JSON.stringify(value);
 }
 //#endregion
-export { ChannelError, handleChannelInput };
+export { ChannelError, deliverChannelRun, handleChannelInput };

package/dist/evals/index.d.mts

@@ -1,7 +1,7 @@
 import { l as JsonValue, o as ExecutionContext, t as AgentEvent } from "../types-CuoRx12Q.mjs";
 import { r as ModelMetadata, s as ModelUsage } from "../index-CTIwrVf9.mjs";
-import { l as TraceCost, t as CostCalculator } from "../index-B4PIkqOU.mjs";
-import { t as Fevex } from "../fevex-Ddyi6z6L.mjs";
+import { l as TraceCost, t as CostCalculator } from "../index-voIZhQXB.mjs";
+import { t as Fevex } from "../fevex-BoPbZ-Tw.mjs";
 //#region src/evals/canonical-json.d.ts
 /** Serializes JSON-like data with stable object-key ordering. */
 declare function serializeCanonical(value: unknown): string;

package/dist/{fevex-Ddyi6z6L.d.mts → fevex-BoPbZ-Tw.d.mts}

@@ -1,13 +1,13 @@
 import { f as RunId, t as AgentEvent } from "./types-CuoRx12Q.mjs";
 import { t as ModelGateway } from "./index-CTIwrVf9.mjs";
-import { A as RunStore, D as RunRequest, E as RunRecord, F as TeamRun, M as SessionId, O as RunResult, S as ResumeRunResolution, U as WorkflowRun, a as AgentRun, b as ListEventsOptions, f as CredentialStore, j as Session, t as AgentDefinition } from "./index-Dx_LotWZ.mjs";
-import { r as ContextProvider, s as MemoryStore } from "./index-DeXUtyd9.mjs";
-import { r as ObservabilityOptions } from "./index-B4PIkqOU.mjs";
+import { A as RunStore, D as RunRequest, E as RunRecord, F as TeamRun, M as SessionId, O as RunResult, S as ResumeRunResolution, U as WorkflowRun, a as AgentRun, b as ListEventsOptions, f as CredentialStore, j as Session, t as AgentDefinition } from "./index-CaE864Kz.mjs";
+import { r as ContextProvider, s as MemoryStore } from "./index-hhbgvfIt.mjs";
+import { r as ObservabilityOptions } from "./index-voIZhQXB.mjs";
 import { r as Sandbox } from "./index-CrOId2px.mjs";
 import { g as ToolDefinition, s as ConnectionDefinition } from "./index-CqOjvtQ9.mjs";
 import { r as PolicyDefinition } from "./index-dkFyTNh4.mjs";
-import { n as WorkflowDefinition } from "./index-DviHtsLo.mjs";
-import { t as TeamDefinition } from "./index-Bg9rr8Qe.mjs";
+import { n as WorkflowDefinition } from "./index-CknU-glw.mjs";
+import { t as TeamDefinition } from "./index-C-IFfCNw.mjs";
 //#region src/fevex.d.ts
 /** Provider-neutral definitions and adapters used to create one Fevex runtime. */
 interface FevexConfig {

package/dist/http/index.d.mts

@@ -1,7 +1,7 @@
 import { l as JsonValue, o as ExecutionContext, t as AgentEvent } from "../types-CuoRx12Q.mjs";
 import { c as ReasoningEffort } from "../index-CTIwrVf9.mjs";
-import { E as RunRecord, F as TeamRun, M as SessionId, U as WorkflowRun, a as AgentRun } from "../index-Dx_LotWZ.mjs";
-import { t as Fevex } from "../fevex-Ddyi6z6L.mjs";
+import { E as RunRecord, F as TeamRun, M as SessionId, U as WorkflowRun, a as AgentRun } from "../index-CaE864Kz.mjs";
+import { t as Fevex } from "../fevex-BoPbZ-Tw.mjs";
 //#region src/http/protocol.d.ts
 declare const FEVEX_HTTP_PROTOCOL_VERSION = "3";
 declare const FEVEX_HTTP_PROTOCOL_VERSION_HEADER = "Fevex-Protocol-Version";

package/dist/{index-Bg9rr8Qe.d.mts → index-C-IFfCNw.d.mts}

@@ -1,7 +1,7 @@
 import { t as ExactDefinition } from "./exact-definition-NHBBFlFR.mjs";
 import { o as ExecutionContext } from "./types-CuoRx12Q.mjs";
-import { n as AgentLimits } from "./index-Dx_LotWZ.mjs";
-import { t as WorkflowAgentResult } from "./index-DviHtsLo.mjs";
+import { n as AgentLimits } from "./index-CaE864Kz.mjs";
+import { t as WorkflowAgentResult } from "./index-CknU-glw.mjs";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 //#region src/teams/team.d.ts
 interface TeamMember {

package/dist/{index-Dx_LotWZ.d.mts → index-CaE864Kz.d.mts}

@@ -1,6 +1,6 @@
 import { t as ExactDefinition } from "./exact-definition-NHBBFlFR.mjs";
 import { f as RunId, i as AgentMessage, l as JsonValue, o as ExecutionContext, s as JsonObject, t as AgentEvent } from "./types-CuoRx12Q.mjs";
-import { c as ReasoningEffort, i as ModelRef, l as ToolChoice, s as ModelUsage } from "./index-CTIwrVf9.mjs";
+import { c as ReasoningEffort, i as ModelRef, l as ToolChoice, r as ModelMetadata, s as ModelUsage } from "./index-CTIwrVf9.mjs";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 //#region src/runtime/run-store.d.ts
 /** Stable identifier for conversation history shared across runs. */
@@ -115,6 +115,9 @@ interface AgentRun<TOutput = JsonValue> {
   id: RunId;
   sessionId: SessionId;
   agentName: string;
+  /** Effective model identity retained after checkpoint cleanup. Absent on older runs. */
+  modelName?: string;
+  modelMetadata?: ModelMetadata;
   status: RunStatus;
   revision: number;
   pause?: RunPause;

package/dist/{index-DviHtsLo.d.mts → index-CknU-glw.d.mts}

@@ -1,6 +1,6 @@
 import { t as ExactDefinition } from "./exact-definition-NHBBFlFR.mjs";
 import { f as RunId, l as JsonValue, o as ExecutionContext, s as JsonObject } from "./types-CuoRx12Q.mjs";
-import { D as RunRequest, M as SessionId, O as RunResult, n as AgentLimits } from "./index-Dx_LotWZ.mjs";
+import { D as RunRequest, M as SessionId, O as RunResult, n as AgentLimits } from "./index-CaE864Kz.mjs";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 //#region src/workflows/workflow.d.ts
 /** Context shared with workflow steps and compensation handlers. */

package/dist/{index-Bgcxgy66.d.mts → index-DyyNLuwO.d.mts}

@@ -1,6 +1,6 @@
-import { o as ExecutionContext, s as JsonObject, t as AgentEvent } from "./types-CuoRx12Q.mjs";
-import { M as SessionId, a as AgentRun, h as ElicitationRequest } from "./index-Dx_LotWZ.mjs";
-import { t as Fevex } from "./fevex-Ddyi6z6L.mjs";
+import { f as RunId, o as ExecutionContext, s as JsonObject, t as AgentEvent } from "./types-CuoRx12Q.mjs";
+import { M as SessionId, a as AgentRun, h as ElicitationRequest } from "./index-CaE864Kz.mjs";
+import { t as Fevex } from "./fevex-BoPbZ-Tw.mjs";
 //#region src/channels/channel.d.ts
 interface ChannelMessage {
   id: string;
@@ -21,11 +21,19 @@ interface ChannelOutput {
 interface ChannelContext {
   signal?: AbortSignal;
 }
+interface ChannelElicitationContext extends ChannelContext {
+  /** Stable key for transport-level idempotency, preserved across delivery retries. */
+  deliveryId: string;
+  runId: RunId;
+  sessionId: SessionId;
+  conversationId: string;
+  threadId?: string;
+}
 interface ChannelAdapter<TInput = unknown, TOutput = unknown> {
   name: string;
   parse(input: TInput, context: ChannelContext): Promise<ChannelMessage | null>;
   deliver(output: ChannelOutput, context: ChannelContext): Promise<TOutput>;
-  deliverElicitation?(request: ElicitationRequest, context: ChannelContext): Promise<TOutput>;
+  deliverElicitation?(request: ElicitationRequest, context: ChannelElicitationContext): Promise<TOutput>;
 }
 type ChannelEventType = 'channel.received' | 'channel.delivered' | 'channel.failed';
 type ChannelFailurePhase = 'parse' | 'run' | 'deliver';
@@ -37,6 +45,8 @@ interface ChannelEventBase {
   deliveryId?: string;
   conversationId?: string;
   threadId?: string;
+  runId?: RunId;
+  requestId?: string;
 }
 type ChannelEvent = (ChannelEventBase & {
   type: 'channel.received';
@@ -53,16 +63,21 @@ declare class ChannelError extends Error {
   readonly code: string;
   readonly safeMessage: string;
   readonly name = "ChannelError";
-  constructor(code: string, safeMessage: string, options?: ErrorOptions);
+  readonly runId?: RunId;
+  constructor(code: string, safeMessage: string, options?: ErrorOptions & {
+    runId?: RunId;
+  });
 }
-interface ChannelRunOptions<TInput = unknown, TDelivery = unknown> {
+interface ChannelDeliveryOptions<TInput = unknown, TDelivery = unknown> {
   fevex: Fevex;
   adapter: ChannelAdapter<TInput, TDelivery>;
-  agentName: string;
-  resolveSessionId?: (message: ChannelMessage) => SessionId | undefined | Promise<SessionId | undefined>;
   onEvent?: (event: ChannelEvent) => void;
   signal?: AbortSignal;
 }
+interface ChannelRunOptions<TInput = unknown, TDelivery = unknown> extends ChannelDeliveryOptions<TInput, TDelivery> {
+  agentName: string;
+  resolveSessionId?: (message: ChannelMessage) => SessionId | undefined | Promise<SessionId | undefined>;
+}
 type ChannelRunResult<TDelivery = unknown> = {
   ignored: true;
   events: ChannelRunEvent[];
@@ -72,11 +87,17 @@ type ChannelRunResult<TDelivery = unknown> = {
   run: AgentRun;
   output: ChannelOutput;
   delivery: TDelivery;
+  /** Present when the agent is waiting for external information. */
+  elicitation?: ElicitationRequest;
   events: ChannelRunEvent[];
 };
 //#endregion
 //#region src/channels/handle-channel-input.d.ts
-/** Parses one channel input, runs the configured agent, and delivers its output. */
+/** Parses one channel input, runs the configured agent, and delivers its result or elicitation. */
 declare function handleChannelInput<TInput, TDelivery>(input: TInput, options: ChannelRunOptions<TInput, TDelivery>): Promise<ChannelRunResult<TDelivery>>;
+/** Delivers a stored agent result or elicitation without executing the agent again. */
+declare function deliverChannelRun<TInput, TDelivery>(runId: RunId, message: ChannelMessage, options: ChannelDeliveryOptions<TInput, TDelivery>): Promise<Exclude<ChannelRunResult<TDelivery>, {
+  ignored: true;
+}>>;
 //#endregion
-export { ChannelEvent as a, ChannelMessage as c, ChannelRunOptions as d, ChannelRunResult as f, ChannelError as i, ChannelOutput as l, ChannelAdapter as n, ChannelEventType as o, ChannelContext as r, ChannelFailurePhase as s, handleChannelInput as t, ChannelRunEvent as u };
+export { ChannelDeliveryOptions as a, ChannelEvent as c, ChannelMessage as d, ChannelOutput as f, ChannelRunResult as h, ChannelContext as i, ChannelEventType as l, ChannelRunOptions as m, handleChannelInput as n, ChannelElicitationContext as o, ChannelRunEvent as p, ChannelAdapter as r, ChannelError as s, deliverChannelRun as t, ChannelFailurePhase as u };

package/dist/{index-DeXUtyd9.d.mts → index-hhbgvfIt.d.mts}

@@ -1,5 +1,5 @@
 import { l as JsonValue, o as ExecutionContext, s as JsonObject } from "./types-CuoRx12Q.mjs";
-import { M as SessionId } from "./index-Dx_LotWZ.mjs";
+import { M as SessionId } from "./index-CaE864Kz.mjs";
 //#region src/knowledge/knowledge.d.ts
 /** Runtime context supplied to knowledge providers and memory stores. */
 interface KnowledgeContext {

package/dist/{index-B4PIkqOU.d.mts → index-voIZhQXB.d.mts}

@@ -1,6 +1,6 @@
 import { f as RunId, l as JsonValue, s as JsonObject } from "./types-CuoRx12Q.mjs";
 import { r as ModelMetadata, s as ModelUsage } from "./index-CTIwrVf9.mjs";
-import { M as SessionId } from "./index-Dx_LotWZ.mjs";
+import { M as SessionId } from "./index-CaE864Kz.mjs";
 //#region src/observability/trace.d.ts
 /** Final state represented by an exported run trace. */
 type TraceStatus = 'completed' | 'failed' | 'cancelled';

package/dist/index.d.mts

@@ -1,14 +1,14 @@
 import { a as AgentMessageRole, c as JsonPrimitive, d as PROVIDER_SCHEMA_UNSUPPORTED, f as RunId, g as ToolSpec, h as ToolEventSource, i as AgentMessage, l as JsonValue, m as ToolCall, n as AgentEventPayloads, o as ExecutionContext, p as SCHEMA_NOT_TRANSPORTABLE, r as AgentEventType, s as JsonObject, t as AgentEvent, u as PROVIDER_REASONING_UNSUPPORTED } from "./types-CuoRx12Q.mjs";
 import { a as ModelResult, c as ReasoningEffort, i as ModelRef, l as ToolChoice, n as ModelInput, o as ModelStreamEvent, r as ModelMetadata, s as ModelUsage, t as ModelGateway } from "./index-CTIwrVf9.mjs";
-import { A as RunStore, B as WorkflowBudgetUsage, C as RunCheckpoint, D as RunRequest, E as RunRecord, F as TeamRun, G as WorkflowWaitRecord, H as WorkflowCompensationRecord, I as TimerResolution, K as isDurableRunStore, L as ToolExecutionRecord, M as SessionId, N as StoredRunCheckpoint, O as RunResult, P as TeamCheckpoint, R as ToolExecutionResolution, S as ResumeRunResolution, T as RunPause, U as WorkflowRun, V as WorkflowCheckpoint, W as WorkflowStepRecord, _ as EventResolution, a as AgentRun, b as ListEventsOptions, c as ApprovalRequest, d as CoordinatorRun, f as CredentialStore, g as ElicitationResolution, h as ElicitationRequest, i as InMemoryRunStore, j as Session, k as RunStatus, l as ApprovalResolution, m as ElicitationMode, n as AgentLimits, o as AgentRunPause, p as DurableRunStore, q as validateListEventsOptions, r as defineAgent, s as ApprovalMode, t as AgentDefinition, u as CoordinatorCheckpoint, v as ExecutionCommit, w as RunLease, x as PendingToolExecution, y as ExecutionCreate, z as ToolExecutionStatus } from "./index-Dx_LotWZ.mjs";
-import { a as MemoryQuery, c as MemoryWrite, d as defineContextProvider, f as defineSkill, i as KnowledgeContext, l as SkillDefinition, n as ContextBlock, o as MemoryRecord, r as ContextProvider, s as MemoryStore, t as InMemoryMemoryStore, u as createMemoryContextProvider } from "./index-DeXUtyd9.mjs";
+import { A as RunStore, B as WorkflowBudgetUsage, C as RunCheckpoint, D as RunRequest, E as RunRecord, F as TeamRun, G as WorkflowWaitRecord, H as WorkflowCompensationRecord, I as TimerResolution, K as isDurableRunStore, L as ToolExecutionRecord, M as SessionId, N as StoredRunCheckpoint, O as RunResult, P as TeamCheckpoint, R as ToolExecutionResolution, S as ResumeRunResolution, T as RunPause, U as WorkflowRun, V as WorkflowCheckpoint, W as WorkflowStepRecord, _ as EventResolution, a as AgentRun, b as ListEventsOptions, c as ApprovalRequest, d as CoordinatorRun, f as CredentialStore, g as ElicitationResolution, h as ElicitationRequest, i as InMemoryRunStore, j as Session, k as RunStatus, l as ApprovalResolution, m as ElicitationMode, n as AgentLimits, o as AgentRunPause, p as DurableRunStore, q as validateListEventsOptions, r as defineAgent, s as ApprovalMode, t as AgentDefinition, u as CoordinatorCheckpoint, v as ExecutionCommit, w as RunLease, x as PendingToolExecution, y as ExecutionCreate, z as ToolExecutionStatus } from "./index-CaE864Kz.mjs";
+import { a as MemoryQuery, c as MemoryWrite, d as defineContextProvider, f as defineSkill, i as KnowledgeContext, l as SkillDefinition, n as ContextBlock, o as MemoryRecord, r as ContextProvider, s as MemoryStore, t as InMemoryMemoryStore, u as createMemoryContextProvider } from "./index-hhbgvfIt.mjs";
 import { a as SandboxError, c as sandboxResultToJson, i as SandboxCapabilities, n as createLocalSandbox, o as SandboxRunRequest, r as Sandbox, s as SandboxRunResult, t as LocalSandboxOptions } from "./index-CrOId2px.mjs";
 import { C as toToolSpec, S as defineTool, _ as ToolExecutionContext, a as compileFevexJsonSchema, b as ToolRetryPolicy, c as ConnectionToolPolicy, d as ToolProvider, f as ToolProviderContext, g as ToolDefinition, h as ToolApproval, i as FevexJsonSchemaValidator, l as IntegrationError, m as defineConnection, n as FevexJsonSchemaProfileLimits, o as validateFevexJsonSchemaProfile, p as ToolProviderTool, r as FevexJsonSchemaProfileOptions, s as ConnectionDefinition, t as FEVEX_JSON_SCHEMA_PROFILE_VERSION, u as IntegrationErrorCategory, v as ToolIdempotency, x as ToolRisk, y as ToolResult } from "./index-CqOjvtQ9.mjs";
 import { i as definePolicy, n as PolicyDecision, r as PolicyDefinition, t as PolicyAuthorization } from "./index-dkFyTNh4.mjs";
-import { a as WorkflowStep, c as defineWorkflow, i as WorkflowEventResult, n as WorkflowDefinition, o as WorkflowStepContext, r as WorkflowEventDefinition, s as WorkflowStepOptions, t as WorkflowAgentResult } from "./index-DviHtsLo.mjs";
-import { a as TeamMember, c as defineTeam, i as TeamLimits, n as TeamDelegation, o as TeamStep, r as TeamHandoff, s as TeamTaskResult, t as TeamDefinition } from "./index-Bg9rr8Qe.mjs";
-import { n as FevexConfig, r as createFevex, t as Fevex } from "./fevex-Ddyi6z6L.mjs";
-import { a as ChannelEvent, c as ChannelMessage, d as ChannelRunOptions, f as ChannelRunResult, i as ChannelError, l as ChannelOutput, n as ChannelAdapter, o as ChannelEventType, r as ChannelContext, s as ChannelFailurePhase, t as handleChannelInput, u as ChannelRunEvent } from "./index-Bgcxgy66.mjs";
+import { a as WorkflowStep, c as defineWorkflow, i as WorkflowEventResult, n as WorkflowDefinition, o as WorkflowStepContext, r as WorkflowEventDefinition, s as WorkflowStepOptions, t as WorkflowAgentResult } from "./index-CknU-glw.mjs";
+import { a as TeamMember, c as defineTeam, i as TeamLimits, n as TeamDelegation, o as TeamStep, r as TeamHandoff, s as TeamTaskResult, t as TeamDefinition } from "./index-C-IFfCNw.mjs";
+import { n as FevexConfig, r as createFevex, t as Fevex } from "./fevex-BoPbZ-Tw.mjs";
+import { a as ChannelDeliveryOptions, c as ChannelEvent, d as ChannelMessage, f as ChannelOutput, h as ChannelRunResult, i as ChannelContext, l as ChannelEventType, m as ChannelRunOptions, n as handleChannelInput, o as ChannelElicitationContext, p as ChannelRunEvent, r as ChannelAdapter, s as ChannelError, t as deliverChannelRun, u as ChannelFailurePhase } from "./index-DyyNLuwO.mjs";
 //#region src/configuration-error.d.ts
 /**
  * Composition error codes.
@@ -39,4 +39,4 @@ declare class RunPausedError extends FevexRunError {
   constructor(runId: RunId, pause: RunPause);
 }
 //#endregion
-export { AgentDefinition, AgentEvent, AgentEventPayloads, AgentEventType, AgentLimits, AgentMessage, AgentMessageRole, AgentRun, AgentRunPause, ApprovalMode, ApprovalRequest, ApprovalResolution, ChannelAdapter, ChannelContext, ChannelError, ChannelEvent, ChannelEventType, ChannelFailurePhase, ChannelMessage, ChannelOutput, ChannelRunEvent, ChannelRunOptions, ChannelRunResult, ConnectionDefinition, ConnectionToolPolicy, ContextBlock, ContextProvider, CoordinatorCheckpoint, CoordinatorRun, CredentialStore, DurableRunStore, ElicitationMode, ElicitationRequest, ElicitationResolution, EventResolution, ExecutionCommit, ExecutionContext, ExecutionCreate, FEVEX_JSON_SCHEMA_PROFILE_VERSION, Fevex, FevexConfig, FevexConfigurationError, FevexConfigurationErrorCode, FevexJsonSchemaProfileLimits, FevexJsonSchemaProfileOptions, FevexJsonSchemaValidator, FevexRunError, FevexRunErrorCode, InMemoryMemoryStore, InMemoryRunStore, IntegrationError, IntegrationErrorCategory, JsonObject, JsonPrimitive, JsonValue, KnowledgeContext, ListEventsOptions, LocalSandboxOptions, MemoryQuery, MemoryRecord, MemoryStore, MemoryWrite, ModelGateway, ModelInput, ModelMetadata, ModelRef, ModelResult, ModelStreamEvent, ModelUsage, PROVIDER_REASONING_UNSUPPORTED, PROVIDER_SCHEMA_UNSUPPORTED, PendingToolExecution, PolicyAuthorization, PolicyDecision, PolicyDefinition, ReasoningEffort, ResumeRunResolution, RunCheckpoint, RunId, RunLease, RunPause, RunPausedError, RunRecord, RunRequest, RunResult, RunStatus, RunStore, SCHEMA_NOT_TRANSPORTABLE, Sandbox, SandboxCapabilities, SandboxError, SandboxRunRequest, SandboxRunResult, Session, SessionId, SkillDefinition, StoredRunCheckpoint, TeamCheckpoint, type TeamDefinition, type TeamDelegation, type TeamHandoff, type TeamLimits, type TeamMember, TeamRun, type TeamStep, type TeamTaskResult, TimerResolution, ToolApproval, ToolCall, ToolChoice, ToolDefinition, ToolEventSource, ToolExecutionContext, ToolExecutionRecord, ToolExecutionResolution, ToolExecutionStatus, ToolIdempotency, ToolProvider, ToolProviderContext, ToolProviderTool, ToolResult, ToolRetryPolicy, ToolRisk, ToolSpec, WorkflowAgentResult, WorkflowBudgetUsage, WorkflowCheckpoint, WorkflowCompensationRecord, WorkflowDefinition, WorkflowEventDefinition, WorkflowEventResult, WorkflowRun, WorkflowStep, WorkflowStepContext, WorkflowStepOptions, WorkflowStepRecord, WorkflowWaitRecord, compileFevexJsonSchema, createFevex, createLocalSandbox, createMemoryContextProvider, defineAgent, defineConnection, defineContextProvider, definePolicy, defineSkill, defineTeam, defineTool, defineWorkflow, handleChannelInput, isDurableRunStore, sandboxResultToJson, toToolSpec, validateFevexJsonSchemaProfile, validateListEventsOptions };
+export { AgentDefinition, AgentEvent, AgentEventPayloads, AgentEventType, AgentLimits, AgentMessage, AgentMessageRole, AgentRun, AgentRunPause, ApprovalMode, ApprovalRequest, ApprovalResolution, ChannelAdapter, ChannelContext, ChannelDeliveryOptions, ChannelElicitationContext, ChannelError, ChannelEvent, ChannelEventType, ChannelFailurePhase, ChannelMessage, ChannelOutput, ChannelRunEvent, ChannelRunOptions, ChannelRunResult, ConnectionDefinition, ConnectionToolPolicy, ContextBlock, ContextProvider, CoordinatorCheckpoint, CoordinatorRun, CredentialStore, DurableRunStore, ElicitationMode, ElicitationRequest, ElicitationResolution, EventResolution, ExecutionCommit, ExecutionContext, ExecutionCreate, FEVEX_JSON_SCHEMA_PROFILE_VERSION, Fevex, FevexConfig, FevexConfigurationError, FevexConfigurationErrorCode, FevexJsonSchemaProfileLimits, FevexJsonSchemaProfileOptions, FevexJsonSchemaValidator, FevexRunError, FevexRunErrorCode, InMemoryMemoryStore, InMemoryRunStore, IntegrationError, IntegrationErrorCategory, JsonObject, JsonPrimitive, JsonValue, KnowledgeContext, ListEventsOptions, LocalSandboxOptions, MemoryQuery, MemoryRecord, MemoryStore, MemoryWrite, ModelGateway, ModelInput, ModelMetadata, ModelRef, ModelResult, ModelStreamEvent, ModelUsage, PROVIDER_REASONING_UNSUPPORTED, PROVIDER_SCHEMA_UNSUPPORTED, PendingToolExecution, PolicyAuthorization, PolicyDecision, PolicyDefinition, ReasoningEffort, ResumeRunResolution, RunCheckpoint, RunId, RunLease, RunPause, RunPausedError, RunRecord, RunRequest, RunResult, RunStatus, RunStore, SCHEMA_NOT_TRANSPORTABLE, Sandbox, SandboxCapabilities, SandboxError, SandboxRunRequest, SandboxRunResult, Session, SessionId, SkillDefinition, StoredRunCheckpoint, TeamCheckpoint, type TeamDefinition, type TeamDelegation, type TeamHandoff, type TeamLimits, type TeamMember, TeamRun, type TeamStep, type TeamTaskResult, TimerResolution, ToolApproval, ToolCall, ToolChoice, ToolDefinition, ToolEventSource, ToolExecutionContext, ToolExecutionRecord, ToolExecutionResolution, ToolExecutionStatus, ToolIdempotency, ToolProvider, ToolProviderContext, ToolProviderTool, ToolResult, ToolRetryPolicy, ToolRisk, ToolSpec, WorkflowAgentResult, WorkflowBudgetUsage, WorkflowCheckpoint, WorkflowCompensationRecord, WorkflowDefinition, WorkflowEventDefinition, WorkflowEventResult, WorkflowRun, WorkflowStep, WorkflowStepContext, WorkflowStepOptions, WorkflowStepRecord, WorkflowWaitRecord, compileFevexJsonSchema, createFevex, createLocalSandbox, createMemoryContextProvider, defineAgent, defineConnection, defineContextProvider, definePolicy, defineSkill, defineTeam, defineTool, defineWorkflow, deliverChannelRun, handleChannelInput, isDurableRunStore, sandboxResultToJson, toToolSpec, validateFevexJsonSchemaProfile, validateListEventsOptions };

package/dist/index.mjs

@@ -1,8 +1,8 @@
 import { defineAgent } from "./agents/index.mjs";
-import { ChannelError, handleChannelInput } from "./channels/index.mjs";
+import { n as RunPausedError, t as FevexRunError } from "./run-error-Cr17wPGH.mjs";
+import { ChannelError, deliverChannelRun, handleChannelInput } from "./channels/index.mjs";
 import { InMemoryMemoryStore, createMemoryContextProvider, defineContextProvider, defineSkill } from "./knowledge/index.mjs";
 import { n as teamAsWorkflow, t as defineTeam } from "./teams-Ctz676G4.mjs";
-import { n as RunPausedError, t as FevexRunError } from "./run-error-Cr17wPGH.mjs";
 import { InMemoryRunStore, isDurableRunStore, validateListEventsOptions } from "./runtime/index.mjs";
 import { FEVEX_JSON_SCHEMA_PROFILE_VERSION, IntegrationError, compileFevexJsonSchema, defineConnection, defineTool, toToolSpec, validateFevexJsonSchemaProfile } from "./tools/index.mjs";
 import { a as assertTokenBudget, c as remainingOutputTokens, d as serializeValue, f as toJsonValue, i as assertContinuationBudget, l as toErrorMessage, n as abortable, o as cancellationReason, r as addUsage, s as eventUsage, t as readModelStream, u as serializeJsonValue } from "./model-stream-u2xMsEaf.mjs";
@@ -871,7 +871,7 @@ function createAgentEngine(composition, core) {
 	const prepareExecution = async (name, request) => {
 		const agent = agents.get(name);
 		if (!agent) throw new FevexRunError("AGENT_NOT_FOUND", `Agent "${name}" is not registered`);
-		const { modelName } = resolveModel(agent, request.model);
+		const { modelName, model } = resolveModel(agent, request.model);
 		const now = (/* @__PURE__ */ new Date()).toISOString();
 		let session;
 		const newSession = request.sessionId === void 0;
@@ -894,6 +894,8 @@ function createAgentEngine(composition, core) {
 			id: crypto.randomUUID(),
 			sessionId: session.id,
 			agentName: name,
+			modelName,
+			...model.metadata === void 0 ? {} : { modelMetadata: structuredClone(model.metadata) },
 			status: "running",
 			revision: 0,
 			createdAt: now,
@@ -1675,6 +1677,10 @@ function createAgentEngine(composition, core) {
 		const checkpointModel = await resolveCheckpointModel(run.agentName, agent, checkpoint);
 		if (!checkpointModel) throw new FevexRunError("RUN_DEFINITION_CHANGED", `Definition for agent "${run.agentName}" changed`, runId);
 		const { modelName, model } = checkpointModel;
+		if (run.modelName === void 0) {
+			run.modelName = modelName;
+			run.modelMetadata = model.metadata === void 0 ? void 0 : structuredClone(model.metadata);
+		}
 		if (checkpoint.providerState !== void 0 && !model.stateCodec) throw new FevexRunError("RUN_NOT_RESUMABLE", "ModelGateway no longer provides its stateCodec", runId);
 		const session = await runStore.getSession(run.sessionId);
 		if (!session) throw new Error(`Session "${run.sessionId}" does not exist`);
@@ -2271,11 +2277,17 @@ function createRunCore({ models, agents, tools, runStore, policies, onEvent, obs
 			if (!run) throw new Error(`Run "${event.runId}" does not exist`);
 			if (isCoordinatorRun(run)) return;
 			const agentRun = run;
-			const agent = agents.get(agentRun.agentName);
-			if (!agent) throw new Error(`Agent "${agentRun.agentName}" is not registered`);
-			const checkpoint = isDurableRunStore(runStore) ? await runStore.getCheckpoint(agentRun.id) : void 0;
-			const { modelName: modelRegistryName, model: gateway } = resolveModel(agent, checkpoint?.modelName);
-			const trace = buildRunTrace(agentRun, await runStore.listEvents(agentRun.id), modelRegistryName, gateway?.metadata, observability);
+			let modelRegistryName = agentRun.modelName;
+			let modelMetadata = agentRun.modelMetadata;
+			if (modelRegistryName === void 0) {
+				const agent = agents.get(agentRun.agentName);
+				if (!agent) throw new Error(`Agent "${agentRun.agentName}" is not registered`);
+				const checkpoint = isDurableRunStore(runStore) ? await runStore.getCheckpoint(agentRun.id) : void 0;
+				const resolved = resolveModel(agent, checkpoint?.modelName);
+				modelRegistryName = resolved.modelName;
+				modelMetadata = resolved.model.metadata;
+			}
+			const trace = buildRunTrace(agentRun, await runStore.listEvents(agentRun.id), modelRegistryName, modelMetadata, observability);
 			const failures = (await Promise.allSettled(observability.exporters.map((exporter) => Promise.resolve().then(() => exporter.export(trace))))).filter((result) => result.status === "rejected").map(({ reason }) => reason);
 			if (failures.length) throw new AggregateError(failures, "Trace export failed");
 		})().catch((error) => {
@@ -3581,4 +3593,4 @@ function createFevex(config) {
 	return createRuntime(createComposition(config));
 }
 //#endregion
-export { ChannelError, FEVEX_JSON_SCHEMA_PROFILE_VERSION, FevexConfigurationError, FevexRunError, InMemoryMemoryStore, InMemoryRunStore, IntegrationError, PROVIDER_REASONING_UNSUPPORTED, PROVIDER_SCHEMA_UNSUPPORTED, RunPausedError, SCHEMA_NOT_TRANSPORTABLE, SandboxError, compileFevexJsonSchema, createFevex, createLocalSandbox, createMemoryContextProvider, defineAgent, defineConnection, defineContextProvider, definePolicy, defineSkill, defineTeam, defineTool, defineWorkflow, handleChannelInput, isDurableRunStore, sandboxResultToJson, toToolSpec, validateFevexJsonSchemaProfile, validateListEventsOptions };
+export { ChannelError, FEVEX_JSON_SCHEMA_PROFILE_VERSION, FevexConfigurationError, FevexRunError, InMemoryMemoryStore, InMemoryRunStore, IntegrationError, PROVIDER_REASONING_UNSUPPORTED, PROVIDER_SCHEMA_UNSUPPORTED, RunPausedError, SCHEMA_NOT_TRANSPORTABLE, SandboxError, compileFevexJsonSchema, createFevex, createLocalSandbox, createMemoryContextProvider, defineAgent, defineConnection, defineContextProvider, definePolicy, defineSkill, defineTeam, defineTool, defineWorkflow, deliverChannelRun, handleChannelInput, isDurableRunStore, sandboxResultToJson, toToolSpec, validateFevexJsonSchemaProfile, validateListEventsOptions };

package/dist/knowledge/index.d.mts

@@ -1,2 +1,2 @@
-import { a as MemoryQuery, c as MemoryWrite, d as defineContextProvider, f as defineSkill, i as KnowledgeContext, l as SkillDefinition, n as ContextBlock, o as MemoryRecord, r as ContextProvider, s as MemoryStore, t as InMemoryMemoryStore, u as createMemoryContextProvider } from "../index-DeXUtyd9.mjs";
+import { a as MemoryQuery, c as MemoryWrite, d as defineContextProvider, f as defineSkill, i as KnowledgeContext, l as SkillDefinition, n as ContextBlock, o as MemoryRecord, r as ContextProvider, s as MemoryStore, t as InMemoryMemoryStore, u as createMemoryContextProvider } from "../index-hhbgvfIt.mjs";
 export { ContextBlock, ContextProvider, InMemoryMemoryStore, KnowledgeContext, MemoryQuery, MemoryRecord, MemoryStore, MemoryWrite, SkillDefinition, createMemoryContextProvider, defineContextProvider, defineSkill };

package/dist/observability/index.d.mts

@@ -1,2 +1,2 @@
-import { a as TraceAnnotation, c as TraceContentPolicy, d as TraceRedactor, f as TraceRedactorInput, h as TraceStatus, i as RunTrace, l as TraceCost, m as TraceSpanKind, n as CostCalculatorInput, o as TraceContent, p as TraceSpan, r as ObservabilityOptions, s as TraceContentKind, t as CostCalculator, u as TraceExporter } from "../index-B4PIkqOU.mjs";
+import { a as TraceAnnotation, c as TraceContentPolicy, d as TraceRedactor, f as TraceRedactorInput, h as TraceStatus, i as RunTrace, l as TraceCost, m as TraceSpanKind, n as CostCalculatorInput, o as TraceContent, p as TraceSpan, r as ObservabilityOptions, s as TraceContentKind, t as CostCalculator, u as TraceExporter } from "../index-voIZhQXB.mjs";
 export { CostCalculator, CostCalculatorInput, ObservabilityOptions, RunTrace, TraceAnnotation, TraceContent, TraceContentKind, TraceContentPolicy, TraceCost, TraceExporter, TraceRedactor, TraceRedactorInput, TraceSpan, TraceSpanKind, TraceStatus };

package/dist/runtime/index.d.mts

@@ -1,2 +1,2 @@
-import { A as RunStore, B as WorkflowBudgetUsage, C as RunCheckpoint, D as RunRequest, E as RunRecord, F as TeamRun, G as WorkflowWaitRecord, H as WorkflowCompensationRecord, I as TimerResolution, K as isDurableRunStore, L as ToolExecutionRecord, M as SessionId, N as StoredRunCheckpoint, O as RunResult, P as TeamCheckpoint, R as ToolExecutionResolution, S as ResumeRunResolution, T as RunPause, U as WorkflowRun, V as WorkflowCheckpoint, W as WorkflowStepRecord, _ as EventResolution, a as AgentRun, b as ListEventsOptions, c as ApprovalRequest, d as CoordinatorRun, f as CredentialStore, g as ElicitationResolution, h as ElicitationRequest, i as InMemoryRunStore, j as Session, k as RunStatus, l as ApprovalResolution, m as ElicitationMode, o as AgentRunPause, p as DurableRunStore, q as validateListEventsOptions, s as ApprovalMode, u as CoordinatorCheckpoint, v as ExecutionCommit, w as RunLease, x as PendingToolExecution, y as ExecutionCreate, z as ToolExecutionStatus } from "../index-Dx_LotWZ.mjs";
+import { A as RunStore, B as WorkflowBudgetUsage, C as RunCheckpoint, D as RunRequest, E as RunRecord, F as TeamRun, G as WorkflowWaitRecord, H as WorkflowCompensationRecord, I as TimerResolution, K as isDurableRunStore, L as ToolExecutionRecord, M as SessionId, N as StoredRunCheckpoint, O as RunResult, P as TeamCheckpoint, R as ToolExecutionResolution, S as ResumeRunResolution, T as RunPause, U as WorkflowRun, V as WorkflowCheckpoint, W as WorkflowStepRecord, _ as EventResolution, a as AgentRun, b as ListEventsOptions, c as ApprovalRequest, d as CoordinatorRun, f as CredentialStore, g as ElicitationResolution, h as ElicitationRequest, i as InMemoryRunStore, j as Session, k as RunStatus, l as ApprovalResolution, m as ElicitationMode, o as AgentRunPause, p as DurableRunStore, q as validateListEventsOptions, s as ApprovalMode, u as CoordinatorCheckpoint, v as ExecutionCommit, w as RunLease, x as PendingToolExecution, y as ExecutionCreate, z as ToolExecutionStatus } from "../index-CaE864Kz.mjs";
 export { AgentRun, AgentRunPause, ApprovalMode, ApprovalRequest, ApprovalResolution, CoordinatorCheckpoint, CoordinatorRun, CredentialStore, DurableRunStore, ElicitationMode, ElicitationRequest, ElicitationResolution, EventResolution, ExecutionCommit, ExecutionCreate, InMemoryRunStore, ListEventsOptions, PendingToolExecution, ResumeRunResolution, RunCheckpoint, RunLease, RunPause, RunRecord, RunRequest, RunResult, RunStatus, RunStore, Session, SessionId, StoredRunCheckpoint, TeamCheckpoint, TeamRun, TimerResolution, ToolExecutionRecord, ToolExecutionResolution, ToolExecutionStatus, WorkflowBudgetUsage, WorkflowCheckpoint, WorkflowCompensationRecord, WorkflowRun, WorkflowStepRecord, WorkflowWaitRecord, isDurableRunStore, validateListEventsOptions };

package/dist/sandbox/index.mjs

@@ -59,8 +59,14 @@ function createLocalSandbox(options) {
 async function runProcess(options) {
 	const started = Date.now();
 	let timedOut = false;
-	let stdout = "";
-	let stderr = "";
+	const stdout = {
+		text: "",
+		bytes: 0
+	};
+	const stderr = {
+		text: "",
+		bytes: 0
+	};
 	return await new Promise((resolvePromise, reject) => {
 		options.signal?.throwIfAborted();
 		const child = spawn(options.command, [...options.args], {
@@ -73,35 +79,51 @@ async function runProcess(options) {
 				"pipe"
 			]
 		});
-		const abort = () => {
+		let aborted = false;
+		let killTimer;
+		const terminate = () => {
+			if (killTimer !== void 0) return;
 			child.kill("SIGTERM");
-			reject(options.signal?.reason ?? new DOMException("Sandbox aborted", "AbortError"));
+			killTimer = setTimeout(() => child.kill("SIGKILL"), 100);
+		};
+		const abort = () => {
+			aborted = true;
+			clearTimeout(timer);
+			terminate();
 		};
 		const timer = setTimeout(() => {
 			timedOut = true;
-			child.kill("SIGTERM");
+			terminate();
 		}, options.timeoutMs);
+		const cleanup = () => {
+			clearTimeout(timer);
+			clearTimeout(killTimer);
+			options.signal?.removeEventListener("abort", abort);
+		};
 		options.signal?.addEventListener("abort", abort, { once: true });
+		if (options.signal?.aborted) abort();
 		child.stdout.setEncoding("utf8");
 		child.stderr.setEncoding("utf8");
 		child.stdout.on("data", (chunk) => {
-			stdout = appendLimited(stdout, String(chunk), options.maxOutputBytes);
+			appendLimited(stdout, String(chunk), options.maxOutputBytes);
 		});
 		child.stderr.on("data", (chunk) => {
-			stderr = appendLimited(stderr, String(chunk), options.maxOutputBytes);
+			appendLimited(stderr, String(chunk), options.maxOutputBytes);
 		});
 		child.on("error", (error) => {
-			clearTimeout(timer);
-			options.signal?.removeEventListener("abort", abort);
+			cleanup();
 			reject(new SandboxError("SANDBOX_PROCESS_ERROR", "Sandbox process failed", { cause: error }));
 		});
 		child.on("close", (exitCode) => {
-			clearTimeout(timer);
-			options.signal?.removeEventListener("abort", abort);
+			cleanup();
+			if (aborted) {
+				reject(options.signal?.reason ?? new DOMException("Sandbox aborted", "AbortError"));
+				return;
+			}
 			resolvePromise({
 				exitCode,
-				stdout,
-				stderr,
+				stdout: stdout.text,
+				stderr: stderr.text,
 				durationMs: Date.now() - started,
 				timedOut
 			});
@@ -110,9 +132,12 @@ async function runProcess(options) {
 		else child.stdin.end();
 	});
 }
-function appendLimited(current, chunk, maxBytes) {
-	const next = current + chunk;
-	return Buffer.byteLength(next) <= maxBytes ? next : next.slice(0, maxBytes);
+function appendLimited(output, chunk, maxBytes) {
+	const remaining = maxBytes - output.bytes;
+	if (remaining <= 0) return;
+	const bytes = Buffer.from(chunk).subarray(0, remaining);
+	output.bytes += bytes.length;
+	output.text += new TextDecoder("utf-8", { ignoreBOM: true }).decode(bytes, { stream: true });
 }
 function isInside(rootDir, value) {
 	const path = relative(rootDir, value);

package/dist/teams/index.d.mts

@@ -1,2 +1,2 @@
-import { a as TeamMember, c as defineTeam, i as TeamLimits, n as TeamDelegation, o as TeamStep, r as TeamHandoff, s as TeamTaskResult, t as TeamDefinition } from "../index-Bg9rr8Qe.mjs";
+import { a as TeamMember, c as defineTeam, i as TeamLimits, n as TeamDelegation, o as TeamStep, r as TeamHandoff, s as TeamTaskResult, t as TeamDefinition } from "../index-C-IFfCNw.mjs";
 export { type TeamDefinition, type TeamDelegation, type TeamHandoff, type TeamLimits, type TeamMember, type TeamStep, type TeamTaskResult, defineTeam };

package/dist/testing/index.d.mts

@@ -1,9 +1,9 @@
 import { m as ToolCall } from "../types-CuoRx12Q.mjs";
 import { a as ModelResult, n as ModelInput, t as ModelGateway } from "../index-CTIwrVf9.mjs";
-import { p as DurableRunStore } from "../index-Dx_LotWZ.mjs";
-import { s as MemoryStore } from "../index-DeXUtyd9.mjs";
+import { h as ElicitationRequest, p as DurableRunStore } from "../index-CaE864Kz.mjs";
+import { s as MemoryStore } from "../index-hhbgvfIt.mjs";
 import { d as ToolProvider } from "../index-CqOjvtQ9.mjs";
-import { c as ChannelMessage, l as ChannelOutput, n as ChannelAdapter } from "../index-Bgcxgy66.mjs";
+import { d as ChannelMessage, f as ChannelOutput, o as ChannelElicitationContext, r as ChannelAdapter } from "../index-DyyNLuwO.mjs";
 //#region src/testing/contracts.d.ts
 interface ModelGatewayContract {
   output?: unknown;
@@ -17,6 +17,11 @@ interface ChannelAdapterContract<TInput, TOutput> {
   output: ChannelOutput;
   delivered: TOutput;
   ignoredInput?: TInput;
+  elicitation?: {
+    request: ElicitationRequest;
+    context: ChannelElicitationContext;
+    delivered: TOutput;
+  };
 }
 interface ToolProviderContract {
   allowedTool: string;

package/dist/testing/index.mjs

@@ -126,6 +126,10 @@ async function testChannelAdapter(adapter, contract) {
 	if (contract.output.threadId !== void 0) assert(contract.output.threadId.trim(), "ChannelOutput threadId cannot be empty");
 	if (contract.output.metadata !== void 0) JSON.stringify(contract.output.metadata);
 	assert(JSON.stringify(await adapter.deliver(contract.output, {})) === JSON.stringify(contract.delivered), "ChannelAdapter returned an unexpected delivery");
+	if (contract.elicitation) {
+		assert(adapter.deliverElicitation, "ChannelAdapter must support elicitation delivery");
+		for (let attempt = 0; attempt < 2; attempt += 1) assert(JSON.stringify(await adapter.deliverElicitation(structuredClone(contract.elicitation.request), { ...contract.elicitation.context })) === JSON.stringify(contract.elicitation.delivered), "ChannelAdapter returned an unexpected elicitation delivery or retry receipt");
+	}
 }
 async function testModelGateway(model, contract = {}) {
 	const output = contract.output ?? { answer: "ok" };

package/dist/workflows/index.d.mts

@@ -1,2 +1,2 @@
-import { a as WorkflowStep, c as defineWorkflow, i as WorkflowEventResult, n as WorkflowDefinition, o as WorkflowStepContext, r as WorkflowEventDefinition, s as WorkflowStepOptions, t as WorkflowAgentResult } from "../index-DviHtsLo.mjs";
+import { a as WorkflowStep, c as defineWorkflow, i as WorkflowEventResult, n as WorkflowDefinition, o as WorkflowStepContext, r as WorkflowEventDefinition, s as WorkflowStepOptions, t as WorkflowAgentResult } from "../index-CknU-glw.mjs";
 export { WorkflowAgentResult, WorkflowDefinition, WorkflowEventDefinition, WorkflowEventResult, WorkflowStep, WorkflowStepContext, WorkflowStepOptions, defineWorkflow };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fevex/core",
-  "version": "0.1.0-alpha.3",
+  "version": "0.1.0-alpha.4",
   "description": "Agent Engineering Framework for code-first, provider-neutral AI agents.",
   "type": "module",
   "license": "Apache-2.0",