@fevex/core 0.1.0-alpha.7 → 0.1.0-alpha.8

package/README.md

@@ -430,6 +430,7 @@ run.started
 model.started
 model.output.delta
 model.completed
+context.compacted
 tool.started
 tool.completed
 tool.failed
@@ -500,6 +501,25 @@ summary when needed:
 await app.compactSession(first.sessionId, 'Account 42 is active.');
 ```
 
+Automatic compaction is opt-in through a context budget:
+
+```ts
+const support = defineAgent({
+  name: 'support',
+  instructions: 'Answer clearly.',
+  contextBudget: { contextWindow: 128_000, reserveOutputTokens: 8_000 },
+});
+```
+
+Before each model call, Fevex estimates the prompt. Above 80% of the usable
+window it replaces older completed turns with a summary, keeps system
+instructions, the current request and the latest tool batch intact, and emits
+`context.compacted`. The summary is cached on the session and reused across
+runs; the original history is not rewritten. Use `compaction.compactor` to
+inject a summarizer; the default is a deterministic digest.
+`limits.maxInputTokens` is still the cumulative spend cap, while
+`contextBudget.contextWindow` is the model context window.
+
 Use `startAgent` when execution must continue without consuming a stream:
 
 ```ts

package/dist/agents/index.d.mts

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

package/dist/artifacts/index.d.mts

@@ -1,2 +1,2 @@
-import { A as ArtifactError, C as FileSystemArtifactStore, D as ArtifactCatalog, E as CatalogedArtifactStoreOptions, F as ArtifactStore, I as ArtifactStoreContext, L as ArtifactWrite, M as ArtifactId, N as ArtifactQuery, O as ArtifactContent, P as ArtifactRecord, R as artifactTenantId, S as InMemoryArtifactCatalog, T as CatalogedArtifactStore, _ as S3ArtifactStore, b as InMemoryArtifactStore, j as ArtifactErrorCode, k as ArtifactDescriptor, v as S3ArtifactStoreOptions, w as FileSystemArtifactStoreOptions, x as InMemoryArtifactStoreOptions, y as S3ObjectClient, z as assertArtifactId } from "../types-B8laW1hM.mjs";
+import { A as ArtifactError, C as FileSystemArtifactStore, D as ArtifactCatalog, E as CatalogedArtifactStoreOptions, F as ArtifactStore, I as ArtifactStoreContext, L as ArtifactWrite, M as ArtifactId, N as ArtifactQuery, O as ArtifactContent, P as ArtifactRecord, R as artifactTenantId, S as InMemoryArtifactCatalog, T as CatalogedArtifactStore, _ as S3ArtifactStore, b as InMemoryArtifactStore, j as ArtifactErrorCode, k as ArtifactDescriptor, v as S3ArtifactStoreOptions, w as FileSystemArtifactStoreOptions, x as InMemoryArtifactStoreOptions, y as S3ObjectClient, z as assertArtifactId } from "../types-CckDlhYo.mjs";
 export { ArtifactCatalog, ArtifactContent, ArtifactDescriptor, ArtifactError, ArtifactErrorCode, ArtifactId, ArtifactQuery, ArtifactRecord, ArtifactStore, ArtifactStoreContext, ArtifactWrite, CatalogedArtifactStore, CatalogedArtifactStoreOptions, FileSystemArtifactStore, FileSystemArtifactStoreOptions, InMemoryArtifactCatalog, InMemoryArtifactStore, InMemoryArtifactStoreOptions, S3ArtifactStore, S3ArtifactStoreOptions, S3ObjectClient, artifactTenantId, assertArtifactId };

package/dist/channels/index.d.mts

@@ -1,2 +1,2 @@
-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-BTD1c4Ys.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-CuaetTLQ.mjs";
 export { ChannelAdapter, ChannelContext, ChannelDeliveryOptions, ChannelElicitationContext, ChannelError, ChannelEvent, ChannelEventType, ChannelFailurePhase, ChannelMessage, ChannelOutput, ChannelRunEvent, ChannelRunOptions, ChannelRunResult, deliverChannelRun, handleChannelInput };

package/dist/evals/index.d.mts

@@ -1,7 +1,7 @@
-import { l as JsonValue, o as ExecutionContext, t as AgentEvent } from "../types-B8laW1hM.mjs";
-import { r as ModelMetadata, s as ModelUsage } from "../index-BgKFd9yw.mjs";
-import { t as CostCalculator, u as TraceCost } from "../index-CpLDt6Rw.mjs";
-import { t as Fevex } from "../fevex-CVMLnZsk.mjs";
+import { l as JsonValue, o as ExecutionContext, t as AgentEvent } from "../types-CckDlhYo.mjs";
+import { r as ModelMetadata, s as ModelUsage } from "../index-BfYzemR8.mjs";
+import { t as CostCalculator, u as TraceCost } from "../index-CecXoEbs.mjs";
+import { t as Fevex } from "../fevex-DB0-k1fb.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-CVMLnZsk.d.mts → fevex-DB0-k1fb.d.mts}

@@ -1,13 +1,13 @@
-import { F as ArtifactStore, f as RunId, o as ExecutionContext, t as AgentEvent } from "./types-B8laW1hM.mjs";
-import { t as ModelGateway } from "./index-BgKFd9yw.mjs";
-import { B as TeamRun, C as PurgeRunsResult, F as RunStore, I as Session, J as WorkflowRun, L as SessionId, M as RunRequest, N as RunResult, S as PurgeRunsOptions, a as AgentRun, b as ListEventsOptions, f as CredentialStore, j as RunRecord, t as AgentDefinition, w as ResumeRunResolution } from "./index-CzAi2Y_Z.mjs";
-import { c as ContextProvider, f as MemoryStore } from "./index-B0AdFbgr.mjs";
-import { i as ObservabilityStats, r as ObservabilityOptions } from "./index-CpLDt6Rw.mjs";
-import { r as Sandbox } from "./index-Df84VWmN.mjs";
-import { g as ToolDefinition, s as ConnectionDefinition } from "./index-5p3q2yIp.mjs";
-import { r as PolicyDefinition } from "./index-CbACw6xZ.mjs";
-import { n as WorkflowDefinition } from "./index-CseuTR-F.mjs";
-import { t as TeamDefinition } from "./index-1cHr7KB_.mjs";
+import { F as ArtifactStore, f as RunId, o as ExecutionContext, t as AgentEvent } from "./types-CckDlhYo.mjs";
+import { t as ModelGateway } from "./index-BfYzemR8.mjs";
+import { A as ListEventsOptions, G as RunStore, H as RunRequest, J as SessionId, K as Session, M as PurgeRunsOptions, N as PurgeRunsResult, P as ResumeRunResolution, S as CredentialStore, U as RunResult, V as RunRecord, Z as TeamRun, at as WorkflowRun, h as AgentRun, r as ContextBudget, s as ContextCompactionOptions, t as AgentDefinition } from "./index-B8molngu.mjs";
+import { c as ContextProvider, f as MemoryStore } from "./index-CAyAoOW0.mjs";
+import { i as ObservabilityStats, r as ObservabilityOptions } from "./index-CecXoEbs.mjs";
+import { r as Sandbox } from "./index-CL7mu_x9.mjs";
+import { g as ToolDefinition, s as ConnectionDefinition } from "./index-DtMxzCqj.mjs";
+import { r as PolicyDefinition } from "./index-Bl0hR7EC.mjs";
+import { n as WorkflowDefinition } from "./index-RKE3-CKs.mjs";
+import { t as TeamDefinition } from "./index-CODYPevS.mjs";
 //#region src/fevex.d.ts
 interface FevexAdmissionRequest {
   kind: 'agent' | 'workflow' | 'team';
@@ -62,6 +62,10 @@ interface FevexConfig {
   tools?: ToolDefinition[];
   connections?: ConnectionDefinition[];
   contextProviders?: ContextProvider[];
+  /** Default context budget for agents that do not declare one. */
+  contextBudget?: ContextBudget;
+  /** Optional context compactor and token estimator. */
+  compaction?: ContextCompactionOptions;
   memoryStore?: MemoryStore;
   runStore?: RunStore;
   credentialStore?: CredentialStore;

package/dist/http/index.d.mts

@@ -1,7 +1,7 @@
-import { D as ArtifactCatalog, F as ArtifactStore, f as RunId, k as ArtifactDescriptor, l as JsonValue, o as ExecutionContext, t as AgentEvent } from "../types-B8laW1hM.mjs";
-import { c as ReasoningEffort } from "../index-BgKFd9yw.mjs";
-import { B as TeamRun, J as WorkflowRun, L as SessionId, a as AgentRun, j as RunRecord } from "../index-CzAi2Y_Z.mjs";
-import { t as Fevex } from "../fevex-CVMLnZsk.mjs";
+import { D as ArtifactCatalog, F as ArtifactStore, f as RunId, k as ArtifactDescriptor, l as JsonValue, o as ExecutionContext, t as AgentEvent } from "../types-CckDlhYo.mjs";
+import { c as ReasoningEffort } from "../index-BfYzemR8.mjs";
+import { J as SessionId, V as RunRecord, Z as TeamRun, at as WorkflowRun, h as AgentRun } from "../index-B8molngu.mjs";
+import { t as Fevex } from "../fevex-DB0-k1fb.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-CzAi2Y_Z.d.mts → index-B8molngu.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-B8laW1hM.mjs";
-import { c as ReasoningEffort, i as ModelRef, l as ToolChoice, r as ModelMetadata, s as ModelUsage } from "./index-BgKFd9yw.mjs";
+import { f as RunId, g as ToolSpec, i as AgentMessage, l as JsonValue, o as ExecutionContext, s as JsonObject, t as AgentEvent } from "./types-CckDlhYo.mjs";
+import { c as ReasoningEffort, i as ModelRef, l as ToolChoice, r as ModelMetadata, s as ModelUsage } from "./index-BfYzemR8.mjs";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 //#region src/runtime/run-store.d.ts
 /** Stable identifier for conversation history shared across runs. */
@@ -170,11 +170,19 @@ interface TeamRun<TOutput = JsonValue> extends RunCorrelation {
 }
 type CoordinatorRun<TOutput = JsonValue> = WorkflowRun<TOutput> | TeamRun<TOutput>;
 type RunRecord<TOutput = unknown> = AgentRun<TOutput> | WorkflowRun<TOutput> | TeamRun<TOutput>;
+interface SessionCompaction {
+  /** Derived summary for the first `coveredMessages` history entries. */
+  summary: string;
+  coveredMessages: number;
+  updatedAt: string;
+}
 interface Session {
   /** Optimistic history revision. Missing on legacy sessions means zero. Store-managed. */
   revision?: number;
   id: SessionId;
   history: AgentMessage[];
+  /** Reusable summary; the original history remains the source of truth. */
+  compaction?: SessionCompaction;
   createdAt: string;
   updatedAt: string;
 }
@@ -246,6 +254,7 @@ interface RunCheckpoint {
   reasoning?: ReasoningEffort;
   definitionHash: string;
   limits?: AgentLimits;
+  contextBudget?: ContextBudget;
   messages: AgentMessage[];
   inputContent: string;
   context?: ExecutionContext;
@@ -392,6 +401,7 @@ interface RunRequest<TInput = unknown, TOutput = unknown> {
   reasoning?: ReasoningEffort;
   context?: ExecutionContext;
   limits?: AgentLimits;
+  contextBudget?: ContextBudget;
   elicitation?: ElicitationMode;
   approvalMode?: ApprovalMode;
   toolChoice?: ToolChoice;
@@ -408,6 +418,68 @@ interface RunResult<TOutput = unknown> {
   usage?: ModelUsage;
 }
 //#endregion
+//#region src/runtime/compaction.d.ts
+/** Estimates the input tokens of messages and tool definitions. */
+type ContextTokenEstimator = (input: {
+  messages: AgentMessage[];
+  tools?: ToolSpec[];
+}) => number;
+interface ContextCompactionInput {
+  agentName: string;
+  sessionId: SessionId;
+  /** Older turns and earlier tool batches; system prefix, current request and latest batch are preserved. */
+  messages: AgentMessage[];
+  tools?: ToolSpec[];
+  /** Estimated tokens of the whole prompt before compaction. */
+  estimatedTokens: number;
+  /** Soft budget for the messages returned by the compactor. */
+  targetTokens: number;
+  /** Hard model context window. */
+  contextWindow: number;
+  step: number;
+  context?: ExecutionContext;
+  signal?: AbortSignal;
+  /** Estimates messages with the runtime's configured estimator. */
+  estimateTokens(messages: AgentMessage[]): number;
+}
+/** Returns the replacement for the older conversation messages. */
+interface ContextCompactor {
+  compact(input: ContextCompactionInput): AgentMessage[] | Promise<AgentMessage[]>;
+}
+interface ContextCompactionOptions {
+  /** Defaults to a deterministic digest compactor. */
+  compactor?: ContextCompactor;
+  /** Defaults to a character-based estimate. */
+  estimateTokens?: ContextTokenEstimator;
+}
+interface ResolvedContextBudget {
+  contextWindow: number;
+  reserveOutputTokens: number;
+  compactAt: number;
+  targetTokens: number;
+  safetyFactor: number;
+}
+/** Validates a context budget and fills in defaults. */
+declare function resolveContextBudget(budget: ContextBudget | undefined, label: string): ResolvedContextBudget | undefined;
+/**
+ * Rough provider-neutral estimate: about four characters per token plus
+ * message and tool framing. Hosts can inject a real tokenizer instead.
+ */
+declare function estimateContextTokens(input: {
+  messages: AgentMessage[];
+  tools?: ToolSpec[];
+}): number;
+interface DigestContextCompactorOptions {
+  /** Maximum characters kept from one message. Defaults to 400. */
+  maxCharsPerMessage?: number;
+}
+/**
+ * Deterministic compactor used when the host does not inject one. It keeps
+ * role-aware excerpts of older messages and drops the oldest excerpts first.
+ * It never calls a model.
+ */
+declare function createDigestContextCompactor(options?: DigestContextCompactorOptions): ContextCompactor;
+//#endregion
 //#region src/runtime/in-memory-run-store.d.ts
 /**
  * In-process durable store intended for development and tests.
@@ -441,6 +513,22 @@ interface AgentLimits {
   maxInputTokens?: number | false;
   maxOutputTokens?: number | false;
 }
+/**
+ * Per-request model context budget. It is separate from
+ * {@link AgentLimits.maxInputTokens}, which caps cumulative spend for a run.
+ */
+interface ContextBudget {
+  /** Model context window in tokens. */
+  contextWindow: number;
+  /** Tokens reserved for the next model output. Defaults to 0. */
+  reserveOutputTokens?: number;
+  /** Fraction of the usable window that triggers compaction. Defaults to 0.8. */
+  compactAt?: number;
+  /** Target tokens after compaction. Defaults below the compaction threshold. */
+  targetTokens?: number;
+  /** Multiplier applied to estimates to leave headroom. Defaults to 1.1. */
+  safetyFactor?: number;
+}
 interface AgentDefinition<TInput = unknown, TOutput = unknown> {
   name: string;
   instructions: string;
@@ -461,7 +549,8 @@ interface AgentDefinition<TInput = unknown, TOutput = unknown> {
   inputSchema?: StandardSchemaV1<unknown, TInput>;
   outputSchema?: StandardSchemaV1<unknown, TOutput>;
   limits?: AgentLimits;
+  contextBudget?: ContextBudget;
 }
 declare function defineAgent<T extends AgentDefinition>(agent: ExactDefinition<T, AgentDefinition>): T;
 //#endregion
-export { validateListEventsOptions as $, RunPause as A, TeamRun as B, PurgeRunsResult as C, RunCheckpoint as D, RetainableRunStore as E, RunStore as F, WorkflowBudgetUsage as G, ToolExecutionRecord as H, Session as I, WorkflowRun as J, WorkflowCheckpoint as K, SessionId as L, RunRequest as M, RunResult as N, RunCorrelation as O, RunStatus as P, isRetainableRunStore as Q, StoredRunCheckpoint as R, PurgeRunsOptions as S, RetainableRunStatus as T, ToolExecutionResolution as U, TimerResolution as V, ToolExecutionStatus as W, WorkflowWaitRecord as X, WorkflowStepRecord as Y, isDurableRunStore as Z, EventResolution as _, AgentRun as a, ListEventsOptions as b, ApprovalRequest as c, CoordinatorRun as d, validatePurgeRunsOptions as et, CredentialStore as f, ElicitationResolution as g, ElicitationRequest as h, InMemoryRunStore as i, RunRecord as j, RunLease as k, ApprovalResolution as l, ElicitationMode as m, AgentLimits as n, AgentRunPause as o, DurableRunStore as p, WorkflowCompensationRecord as q, defineAgent as r, ApprovalMode as s, AgentDefinition as t, CoordinatorCheckpoint as u, ExecutionCommit as v, ResumeRunResolution as w, PendingToolExecution as x, ExecutionCreate as y, TeamCheckpoint as z };
+export { ToolExecutionRecord as $, ListEventsOptions as A, RunPause as B, DurableRunStore as C, EventResolution as D, ElicitationResolution as E, RetainableRunStatus as F, RunStore as G, RunRequest as H, RetainableRunStore as I, SessionId as J, Session as K, RunCheckpoint as L, PurgeRunsOptions as M, PurgeRunsResult as N, ExecutionCommit as O, ResumeRunResolution as P, TimerResolution as Q, RunCorrelation as R, CredentialStore as S, ElicitationRequest as T, RunResult as U, RunRecord as V, RunStatus as W, TeamCheckpoint as X, StoredRunCheckpoint as Y, TeamRun as Z, ApprovalMode as _, InMemoryRunStore as a, WorkflowRun as at, CoordinatorCheckpoint as b, ContextCompactor as c, isDurableRunStore as ct, ResolvedContextBudget as d, validatePurgeRunsOptions as dt, ToolExecutionResolution as et, createDigestContextCompactor as f, AgentRunPause as g, AgentRun as h, defineAgent as i, WorkflowCompensationRecord as it, PendingToolExecution as j, ExecutionCreate as k, ContextTokenEstimator as l, isRetainableRunStore as lt, resolveContextBudget as m, AgentLimits as n, WorkflowBudgetUsage as nt, ContextCompactionInput as o, WorkflowStepRecord as ot, estimateContextTokens as p, SessionCompaction as q, ContextBudget as r, WorkflowCheckpoint as rt, ContextCompactionOptions as s, WorkflowWaitRecord as st, AgentDefinition as t, ToolExecutionStatus as tt, DigestContextCompactorOptions as u, validateListEventsOptions as ut, ApprovalRequest as v, ElicitationMode as w, CoordinatorRun as x, ApprovalResolution as y, RunLease as z };

package/dist/{index-BgKFd9yw.d.mts → index-BfYzemR8.d.mts}

@@ -1,4 +1,4 @@
-import { g as ToolSpec, i as AgentMessage, l as JsonValue, m as ToolCall, s as JsonObject } from "./types-B8laW1hM.mjs";
+import { g as ToolSpec, i as AgentMessage, l as JsonValue, m as ToolCall, s as JsonObject } from "./types-CckDlhYo.mjs";
 //#region src/models/model.d.ts
 /** Provider-neutral reasoning levels accepted by model gateways. */
 type ReasoningEffort = 'provider-default' | 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';

package/dist/{index-CbACw6xZ.d.mts → index-Bl0hR7EC.d.mts}

@@ -1,5 +1,5 @@
-import { f as RunId, l as JsonValue, o as ExecutionContext } from "./types-B8laW1hM.mjs";
-import { x as ToolRisk } from "./index-5p3q2yIp.mjs";
+import { f as RunId, l as JsonValue, o as ExecutionContext } from "./types-CckDlhYo.mjs";
+import { x as ToolRisk } from "./index-DtMxzCqj.mjs";
 //#region src/policies/policy.d.ts
 /** Authorization outcome returned by a policy. */
 type PolicyDecision = 'allow' | 'deny' | 'require_approval';

package/dist/{index-B0AdFbgr.d.mts → index-CAyAoOW0.d.mts}

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

package/dist/{index-Df84VWmN.d.mts → index-CL7mu_x9.d.mts}

@@ -1,4 +1,4 @@
-import { f as RunId, l as JsonValue, o as ExecutionContext } from "./types-B8laW1hM.mjs";
+import { f as RunId, l as JsonValue, o as ExecutionContext } from "./types-CckDlhYo.mjs";
 //#region src/sandbox/sandbox.d.ts
 interface SandboxCapabilities {
   process?: {

package/dist/{index-1cHr7KB_.d.mts → index-CODYPevS.d.mts}

@@ -1,7 +1,7 @@
 import { t as ExactDefinition } from "./exact-definition-NHBBFlFR.mjs";
-import { o as ExecutionContext } from "./types-B8laW1hM.mjs";
-import { n as AgentLimits } from "./index-CzAi2Y_Z.mjs";
-import { t as WorkflowAgentResult } from "./index-CseuTR-F.mjs";
+import { o as ExecutionContext } from "./types-CckDlhYo.mjs";
+import { n as AgentLimits } from "./index-B8molngu.mjs";
+import { t as WorkflowAgentResult } from "./index-RKE3-CKs.mjs";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 //#region src/teams/team.d.ts
 interface TeamMember {

package/dist/{index-CpLDt6Rw.d.mts → index-CecXoEbs.d.mts}

@@ -1,6 +1,6 @@
-import { f as RunId, l as JsonValue, s as JsonObject } from "./types-B8laW1hM.mjs";
-import { r as ModelMetadata, s as ModelUsage } from "./index-BgKFd9yw.mjs";
-import { L as SessionId } from "./index-CzAi2Y_Z.mjs";
+import { f as RunId, l as JsonValue, s as JsonObject } from "./types-CckDlhYo.mjs";
+import { r as ModelMetadata, s as ModelUsage } from "./index-BfYzemR8.mjs";
+import { J as SessionId } from "./index-B8molngu.mjs";
 //#region src/observability/trace.d.ts
 /** Final state represented by an exported run trace. */
 type TraceStatus = 'completed' | 'failed' | 'cancelled';

package/dist/{index-BTD1c4Ys.d.mts → index-CuaetTLQ.d.mts}

@@ -1,6 +1,6 @@
-import { f as RunId, o as ExecutionContext, s as JsonObject, t as AgentEvent } from "./types-B8laW1hM.mjs";
-import { L as SessionId, a as AgentRun, h as ElicitationRequest } from "./index-CzAi2Y_Z.mjs";
-import { t as Fevex } from "./fevex-CVMLnZsk.mjs";
+import { f as RunId, o as ExecutionContext, s as JsonObject, t as AgentEvent } from "./types-CckDlhYo.mjs";
+import { J as SessionId, T as ElicitationRequest, h as AgentRun } from "./index-B8molngu.mjs";
+import { t as Fevex } from "./fevex-DB0-k1fb.mjs";
 //#region src/channels/channel.d.ts
 interface ChannelMessage {
   id: string;

package/dist/{index-5p3q2yIp.d.mts → index-DtMxzCqj.d.mts}

@@ -1,6 +1,6 @@
 import { t as ExactDefinition } from "./exact-definition-NHBBFlFR.mjs";
-import { F as ArtifactStore, f as RunId, g as ToolSpec, h as ToolEventSource, l as JsonValue, o as ExecutionContext, s as JsonObject } from "./types-B8laW1hM.mjs";
-import { i as SandboxCapabilities, r as Sandbox } from "./index-Df84VWmN.mjs";
+import { F as ArtifactStore, f as RunId, g as ToolSpec, h as ToolEventSource, l as JsonValue, o as ExecutionContext, s as JsonObject } from "./types-CckDlhYo.mjs";
+import { i as SandboxCapabilities, r as Sandbox } from "./index-CL7mu_x9.mjs";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 //#region src/tools/tool.d.ts
 interface ToolExecutionContext {

package/dist/{index-CseuTR-F.d.mts → index-RKE3-CKs.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-B8laW1hM.mjs";
-import { L as SessionId, M as RunRequest, N as RunResult, n as AgentLimits } from "./index-CzAi2Y_Z.mjs";
+import { f as RunId, l as JsonValue, o as ExecutionContext, s as JsonObject } from "./types-CckDlhYo.mjs";
+import { H as RunRequest, J as SessionId, U as RunResult, n as AgentLimits } from "./index-B8molngu.mjs";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 //#region src/workflows/workflow.d.ts
 /** Context shared with workflow steps and compensation handlers. */

package/dist/index.d.mts

@@ -1,14 +1,14 @@
-import { A as ArtifactError, C as FileSystemArtifactStore, D as ArtifactCatalog, E as CatalogedArtifactStoreOptions, F as ArtifactStore, I as ArtifactStoreContext, L as ArtifactWrite, M as ArtifactId, N as ArtifactQuery, O as ArtifactContent, P as ArtifactRecord, R as artifactTenantId, S as InMemoryArtifactCatalog, T as CatalogedArtifactStore, _ as S3ArtifactStore, a as AgentMessageRole, b as InMemoryArtifactStore, c as JsonPrimitive, d as PROVIDER_SCHEMA_UNSUPPORTED, f as RunId, g as ToolSpec, h as ToolEventSource, i as AgentMessage, j as ArtifactErrorCode, k as ArtifactDescriptor, 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, v as S3ArtifactStoreOptions, w as FileSystemArtifactStoreOptions, x as InMemoryArtifactStoreOptions, y as S3ObjectClient, z as assertArtifactId } from "./types-B8laW1hM.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-BgKFd9yw.mjs";
-import { $ as validateListEventsOptions, A as RunPause, B as TeamRun, C as PurgeRunsResult, D as RunCheckpoint, E as RetainableRunStore, F as RunStore, G as WorkflowBudgetUsage, H as ToolExecutionRecord, I as Session, J as WorkflowRun, K as WorkflowCheckpoint, L as SessionId, M as RunRequest, N as RunResult, O as RunCorrelation, P as RunStatus, Q as isRetainableRunStore, R as StoredRunCheckpoint, S as PurgeRunsOptions, T as RetainableRunStatus, U as ToolExecutionResolution, V as TimerResolution, W as ToolExecutionStatus, X as WorkflowWaitRecord, Y as WorkflowStepRecord, Z as isDurableRunStore, _ as EventResolution, a as AgentRun, b as ListEventsOptions, c as ApprovalRequest, d as CoordinatorRun, et as validatePurgeRunsOptions, f as CredentialStore, g as ElicitationResolution, h as ElicitationRequest, i as InMemoryRunStore, j as RunRecord, k as RunLease, l as ApprovalResolution, m as ElicitationMode, n as AgentLimits, o as AgentRunPause, p as DurableRunStore, q as WorkflowCompensationRecord, r as defineAgent, s as ApprovalMode, t as AgentDefinition, u as CoordinatorCheckpoint, v as ExecutionCommit, w as ResumeRunResolution, x as PendingToolExecution, y as ExecutionCreate, z as TeamCheckpoint } from "./index-CzAi2Y_Z.mjs";
-import { _ as defineContextProvider, a as AgentsMdOptions, c as ContextProvider, d as MemoryRecord, f as MemoryStore, g as createMemoryContextProvider, h as SkillDefinition, i as InMemoryMemoryStore, l as KnowledgeContext, m as ProgressiveSkillProvider, n as loadSkillFile, o as createAgentsMdContextProvider, p as MemoryWrite, r as loadSkillFiles, s as ContextBlock, t as LoadSkillFileOptions, u as MemoryQuery, v as defineSkill, y as isProgressiveSkillProvider } from "./index-B0AdFbgr.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-Df84VWmN.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-5p3q2yIp.mjs";
-import { i as definePolicy, n as PolicyDecision, r as PolicyDefinition, t as PolicyAuthorization } from "./index-CbACw6xZ.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-CseuTR-F.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-1cHr7KB_.mjs";
-import { a as FevexLimits, c as createFevex, i as FevexConfig, n as FevexAdmission, o as FevexShutdownOptions, r as FevexAdmissionRequest, s as FevexShutdownResult, t as Fevex } from "./fevex-CVMLnZsk.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-BTD1c4Ys.mjs";
+import { A as ArtifactError, C as FileSystemArtifactStore, D as ArtifactCatalog, E as CatalogedArtifactStoreOptions, F as ArtifactStore, I as ArtifactStoreContext, L as ArtifactWrite, M as ArtifactId, N as ArtifactQuery, O as ArtifactContent, P as ArtifactRecord, R as artifactTenantId, S as InMemoryArtifactCatalog, T as CatalogedArtifactStore, _ as S3ArtifactStore, a as AgentMessageRole, b as InMemoryArtifactStore, c as JsonPrimitive, d as PROVIDER_SCHEMA_UNSUPPORTED, f as RunId, g as ToolSpec, h as ToolEventSource, i as AgentMessage, j as ArtifactErrorCode, k as ArtifactDescriptor, 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, v as S3ArtifactStoreOptions, w as FileSystemArtifactStoreOptions, x as InMemoryArtifactStoreOptions, y as S3ObjectClient, z as assertArtifactId } from "./types-CckDlhYo.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-BfYzemR8.mjs";
+import { $ as ToolExecutionRecord, A as ListEventsOptions, B as RunPause, C as DurableRunStore, D as EventResolution, E as ElicitationResolution, F as RetainableRunStatus, G as RunStore, H as RunRequest, I as RetainableRunStore, J as SessionId, K as Session, L as RunCheckpoint, M as PurgeRunsOptions, N as PurgeRunsResult, O as ExecutionCommit, P as ResumeRunResolution, Q as TimerResolution, R as RunCorrelation, S as CredentialStore, T as ElicitationRequest, U as RunResult, V as RunRecord, W as RunStatus, X as TeamCheckpoint, Y as StoredRunCheckpoint, Z as TeamRun, _ as ApprovalMode, a as InMemoryRunStore, at as WorkflowRun, b as CoordinatorCheckpoint, c as ContextCompactor, ct as isDurableRunStore, d as ResolvedContextBudget, dt as validatePurgeRunsOptions, et as ToolExecutionResolution, f as createDigestContextCompactor, g as AgentRunPause, h as AgentRun, i as defineAgent, it as WorkflowCompensationRecord, j as PendingToolExecution, k as ExecutionCreate, l as ContextTokenEstimator, lt as isRetainableRunStore, m as resolveContextBudget, n as AgentLimits, nt as WorkflowBudgetUsage, o as ContextCompactionInput, ot as WorkflowStepRecord, p as estimateContextTokens, q as SessionCompaction, r as ContextBudget, rt as WorkflowCheckpoint, s as ContextCompactionOptions, st as WorkflowWaitRecord, t as AgentDefinition, tt as ToolExecutionStatus, u as DigestContextCompactorOptions, ut as validateListEventsOptions, v as ApprovalRequest, w as ElicitationMode, x as CoordinatorRun, y as ApprovalResolution, z as RunLease } from "./index-B8molngu.mjs";
+import { _ as defineContextProvider, a as AgentsMdOptions, c as ContextProvider, d as MemoryRecord, f as MemoryStore, g as createMemoryContextProvider, h as SkillDefinition, i as InMemoryMemoryStore, l as KnowledgeContext, m as ProgressiveSkillProvider, n as loadSkillFile, o as createAgentsMdContextProvider, p as MemoryWrite, r as loadSkillFiles, s as ContextBlock, t as LoadSkillFileOptions, u as MemoryQuery, v as defineSkill, y as isProgressiveSkillProvider } from "./index-CAyAoOW0.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-CL7mu_x9.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-DtMxzCqj.mjs";
+import { i as definePolicy, n as PolicyDecision, r as PolicyDefinition, t as PolicyAuthorization } from "./index-Bl0hR7EC.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-RKE3-CKs.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-CODYPevS.mjs";
+import { a as FevexLimits, c as createFevex, i as FevexConfig, n as FevexAdmission, o as FevexShutdownOptions, r as FevexAdmissionRequest, s as FevexShutdownResult, t as Fevex } from "./fevex-DB0-k1fb.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-CuaetTLQ.mjs";
 //#region src/configuration-error.d.ts
 /**
  * Composition error codes.
@@ -25,7 +25,7 @@ declare class FevexConfigurationError extends Error {
 }
 //#endregion
 //#region src/run-error.d.ts
-type FevexRunErrorCode = 'INVALID_CURSOR' | 'AGENT_NOT_FOUND' | 'WORKFLOW_NOT_FOUND' | 'TEAM_NOT_FOUND' | 'MODEL_NOT_FOUND' | 'SESSION_NOT_FOUND' | 'DURABLE_STORE_REQUIRED' | 'RUN_CONFLICT' | 'RUN_NOT_RESUMABLE' | 'RUN_NOT_RECOVERABLE' | 'CHECKPOINT_UNSUPPORTED' | 'RUN_DEFINITION_CHANGED' | 'POLICY_DENIED' | 'ADMISSION_DENIED' | 'RUNTIME_CLOSED' | 'RETENTION_UNSUPPORTED' | 'EVENT_LIMIT_EXCEEDED' | 'CREDENTIAL_NOT_FOUND' | 'SANDBOX_REQUIRED' | 'ELICITATION_INVALID' | 'APPROVAL_INVALID' | 'RUN_PAUSED' | 'TOOL_EXECUTION_UNKNOWN';
+type FevexRunErrorCode = 'INVALID_CURSOR' | 'AGENT_NOT_FOUND' | 'WORKFLOW_NOT_FOUND' | 'TEAM_NOT_FOUND' | 'MODEL_NOT_FOUND' | 'SESSION_NOT_FOUND' | 'DURABLE_STORE_REQUIRED' | 'RUN_CONFLICT' | 'RUN_NOT_RESUMABLE' | 'RUN_NOT_RECOVERABLE' | 'CHECKPOINT_UNSUPPORTED' | 'RUN_DEFINITION_CHANGED' | 'POLICY_DENIED' | 'ADMISSION_DENIED' | 'RUNTIME_CLOSED' | 'RETENTION_UNSUPPORTED' | 'EVENT_LIMIT_EXCEEDED' | 'CONTEXT_BUDGET_EXCEEDED' | 'CREDENTIAL_NOT_FOUND' | 'SANDBOX_REQUIRED' | 'ELICITATION_INVALID' | 'APPROVAL_INVALID' | 'RUN_PAUSED' | 'TOOL_EXECUTION_UNKNOWN';
 declare class FevexRunError extends Error {
   readonly code: FevexRunErrorCode;
   readonly runId?: RunId | undefined;
@@ -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, AgentsMdOptions, ApprovalMode, ApprovalRequest, ApprovalResolution, ArtifactCatalog, ArtifactContent, ArtifactDescriptor, ArtifactError, ArtifactErrorCode, ArtifactId, ArtifactQuery, ArtifactRecord, ArtifactStore, ArtifactStoreContext, ArtifactWrite, CatalogedArtifactStore, CatalogedArtifactStoreOptions, 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, FevexAdmission, FevexAdmissionRequest, FevexConfig, FevexConfigurationError, FevexConfigurationErrorCode, FevexJsonSchemaProfileLimits, FevexJsonSchemaProfileOptions, FevexJsonSchemaValidator, FevexLimits, FevexRunError, FevexRunErrorCode, FevexShutdownOptions, FevexShutdownResult, FileSystemArtifactStore, FileSystemArtifactStoreOptions, InMemoryArtifactCatalog, InMemoryArtifactStore, InMemoryArtifactStoreOptions, InMemoryMemoryStore, InMemoryRunStore, IntegrationError, IntegrationErrorCategory, JsonObject, JsonPrimitive, JsonValue, KnowledgeContext, ListEventsOptions, LoadSkillFileOptions, LocalSandboxOptions, MemoryQuery, MemoryRecord, MemoryStore, MemoryWrite, ModelGateway, ModelInput, ModelMetadata, ModelRef, ModelResult, ModelStreamEvent, ModelUsage, PROVIDER_REASONING_UNSUPPORTED, PROVIDER_SCHEMA_UNSUPPORTED, PendingToolExecution, PolicyAuthorization, PolicyDecision, PolicyDefinition, ProgressiveSkillProvider, PurgeRunsOptions, PurgeRunsResult, ReasoningEffort, ResumeRunResolution, RetainableRunStatus, RetainableRunStore, RunCheckpoint, RunCorrelation, RunId, RunLease, RunPause, RunPausedError, RunRecord, RunRequest, RunResult, RunStatus, RunStore, S3ArtifactStore, S3ArtifactStoreOptions, S3ObjectClient, 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, artifactTenantId, assertArtifactId, compileFevexJsonSchema, createAgentsMdContextProvider, createFevex, createLocalSandbox, createMemoryContextProvider, defineAgent, defineConnection, defineContextProvider, definePolicy, defineSkill, defineTeam, defineTool, defineWorkflow, deliverChannelRun, handleChannelInput, isDurableRunStore, isProgressiveSkillProvider, isRetainableRunStore, loadSkillFile, loadSkillFiles, sandboxResultToJson, toToolSpec, validateFevexJsonSchemaProfile, validateListEventsOptions, validatePurgeRunsOptions };
+export { AgentDefinition, AgentEvent, AgentEventPayloads, AgentEventType, AgentLimits, AgentMessage, AgentMessageRole, AgentRun, AgentRunPause, AgentsMdOptions, ApprovalMode, ApprovalRequest, ApprovalResolution, ArtifactCatalog, ArtifactContent, ArtifactDescriptor, ArtifactError, ArtifactErrorCode, ArtifactId, ArtifactQuery, ArtifactRecord, ArtifactStore, ArtifactStoreContext, ArtifactWrite, CatalogedArtifactStore, CatalogedArtifactStoreOptions, ChannelAdapter, ChannelContext, ChannelDeliveryOptions, ChannelElicitationContext, ChannelError, ChannelEvent, ChannelEventType, ChannelFailurePhase, ChannelMessage, ChannelOutput, ChannelRunEvent, ChannelRunOptions, ChannelRunResult, ConnectionDefinition, ConnectionToolPolicy, ContextBlock, ContextBudget, ContextCompactionInput, ContextCompactionOptions, ContextCompactor, ContextProvider, ContextTokenEstimator, CoordinatorCheckpoint, CoordinatorRun, CredentialStore, DigestContextCompactorOptions, DurableRunStore, ElicitationMode, ElicitationRequest, ElicitationResolution, EventResolution, ExecutionCommit, ExecutionContext, ExecutionCreate, FEVEX_JSON_SCHEMA_PROFILE_VERSION, Fevex, FevexAdmission, FevexAdmissionRequest, FevexConfig, FevexConfigurationError, FevexConfigurationErrorCode, FevexJsonSchemaProfileLimits, FevexJsonSchemaProfileOptions, FevexJsonSchemaValidator, FevexLimits, FevexRunError, FevexRunErrorCode, FevexShutdownOptions, FevexShutdownResult, FileSystemArtifactStore, FileSystemArtifactStoreOptions, InMemoryArtifactCatalog, InMemoryArtifactStore, InMemoryArtifactStoreOptions, InMemoryMemoryStore, InMemoryRunStore, IntegrationError, IntegrationErrorCategory, JsonObject, JsonPrimitive, JsonValue, KnowledgeContext, ListEventsOptions, LoadSkillFileOptions, LocalSandboxOptions, MemoryQuery, MemoryRecord, MemoryStore, MemoryWrite, ModelGateway, ModelInput, ModelMetadata, ModelRef, ModelResult, ModelStreamEvent, ModelUsage, PROVIDER_REASONING_UNSUPPORTED, PROVIDER_SCHEMA_UNSUPPORTED, PendingToolExecution, PolicyAuthorization, PolicyDecision, PolicyDefinition, ProgressiveSkillProvider, PurgeRunsOptions, PurgeRunsResult, ReasoningEffort, ResolvedContextBudget, ResumeRunResolution, RetainableRunStatus, RetainableRunStore, RunCheckpoint, RunCorrelation, RunId, RunLease, RunPause, RunPausedError, RunRecord, RunRequest, RunResult, RunStatus, RunStore, S3ArtifactStore, S3ArtifactStoreOptions, S3ObjectClient, SCHEMA_NOT_TRANSPORTABLE, Sandbox, SandboxCapabilities, SandboxError, SandboxRunRequest, SandboxRunResult, Session, SessionCompaction, 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, artifactTenantId, assertArtifactId, compileFevexJsonSchema, createAgentsMdContextProvider, createDigestContextCompactor, createFevex, createLocalSandbox, createMemoryContextProvider, defineAgent, defineConnection, defineContextProvider, definePolicy, defineSkill, defineTeam, defineTool, defineWorkflow, deliverChannelRun, estimateContextTokens, handleChannelInput, isDurableRunStore, isProgressiveSkillProvider, isRetainableRunStore, loadSkillFile, loadSkillFiles, resolveContextBudget, sandboxResultToJson, toToolSpec, validateFevexJsonSchemaProfile, validateListEventsOptions, validatePurgeRunsOptions };

package/dist/index.mjs

@@ -4,7 +4,7 @@ import { n as RunPausedError, t as FevexRunError } from "./run-error-Cr17wPGH.mj
 import { ChannelError, deliverChannelRun, handleChannelInput } from "./channels/index.mjs";
 import { InMemoryMemoryStore, createAgentsMdContextProvider, createMemoryContextProvider, defineContextProvider, defineSkill, isProgressiveSkillProvider, loadSkillFile, loadSkillFiles } from "./knowledge/index.mjs";
 import { n as teamAsWorkflow, t as defineTeam } from "./teams-Ctz676G4.mjs";
-import { InMemoryRunStore, isDurableRunStore, isRetainableRunStore, validateListEventsOptions, validatePurgeRunsOptions } from "./runtime/index.mjs";
+import { InMemoryRunStore, createDigestContextCompactor, estimateContextTokens, isDurableRunStore, isRetainableRunStore, resolveContextBudget, validateListEventsOptions, validatePurgeRunsOptions } from "./runtime/index.mjs";
 import { FEVEX_JSON_SCHEMA_PROFILE_VERSION, IntegrationError, compileFevexJsonSchema, defineConnection, defineTool, toToolSpec, validateFevexJsonSchemaProfile } from "./tools/index.mjs";
 import { _ as serializeValue, a as assertTokenBudget, c as eventUsage, d as remainingDeadlineMs, f as remainingOutputTokens, g as serializeJsonValue, h as toErrorMessage, i as assertContinuationBudget, l as isTimeoutError, m as runSignal, n as abortable, o as cancellationReason, p as resumeDeadlineSignal, r as addUsage, s as deadlineAtFromMs, u as minDeadline, v as toJsonValue } from "./run-support-CmZ6Xo6H.mjs";
 import { t as readModelStream } from "./model-stream-JQdHDDcj.mjs";
@@ -300,6 +300,16 @@ function createComposition(config) {
 	assertConfiguration(config.tools === void 0 || Array.isArray(config.tools), "INVALID_CONFIG", "Fevex config \"tools\" must be an array");
 	assertConfiguration(config.connections === void 0 || Array.isArray(config.connections), "INVALID_CONFIG", "Fevex config \"connections\" must be an array");
 	assertConfiguration(config.contextProviders === void 0 || Array.isArray(config.contextProviders), "INVALID_CONFIG", "Fevex config \"contextProviders\" must be an array");
+	if (config.contextBudget !== void 0) try {
+		resolveContextBudget(config.contextBudget, "Fevex config \"contextBudget\"");
+	} catch (error) {
+		throw configurationError("INVALID_CONFIG", error.message);
+	}
+	if (config.compaction !== void 0) {
+		assertConfiguration(typeof config.compaction === "object" && config.compaction !== null && !Array.isArray(config.compaction), "INVALID_CONFIG", "Fevex config \"compaction\" must be an object");
+		assertConfiguration(config.compaction.compactor === void 0 || isRecord(config.compaction.compactor) && typeof config.compaction.compactor.compact === "function", "INVALID_CONFIG", "Fevex config \"compaction.compactor\" must implement compact");
+		assertConfiguration(config.compaction.estimateTokens === void 0 || typeof config.compaction.estimateTokens === "function", "INVALID_CONFIG", "Fevex config \"compaction.estimateTokens\" must be a function");
+	}
 	assertConfiguration(config.memoryStore === void 0 || isMemoryStore(config.memoryStore), "INVALID_CONFIG", "Fevex config \"memoryStore\" must implement MemoryStore");
 	assertConfiguration(config.onEvent === void 0 || typeof config.onEvent === "function", "INVALID_CONFIG", "Fevex config \"onEvent\" must be a function");
 	assertConfiguration(config.runStore === void 0 || isRunStore(config.runStore), "INVALID_CONFIG", "Fevex config \"runStore\" must implement RunStore");
@@ -475,6 +485,11 @@ function createComposition(config) {
 		assertConfiguration(definition.approvalMode === void 0 || definition.approvalMode === "pause" || definition.approvalMode === "deny", "INVALID_AGENT", `Agent "${name}" approvalMode is invalid`);
 		assertConfiguration(definition.toolChoice === void 0 || definition.toolChoice === "auto" || definition.toolChoice === "required" || definition.toolChoice === "none" || isRecord(definition.toolChoice) && typeof definition.toolChoice.name === "string" && Boolean(definition.toolChoice.name.trim()), "INVALID_AGENT", `Agent "${name}" toolChoice is invalid`);
 		assertConfiguration(definition.limits === void 0 || isRecord(definition.limits), "INVALID_AGENT", `Agent "${name}" limits must be an object`);
+		if (definition.contextBudget !== void 0) try {
+			resolveContextBudget(definition.contextBudget, `Agent "${name}" contextBudget`);
+		} catch (error) {
+			throw configurationError("INVALID_AGENT", error.message);
+		}
 		if (definition.outputSchema !== void 0) assertConfiguration(isStandardSchema(definition.outputSchema), "INVALID_AGENT", `Output schema for agent "${name}" must implement Standard Schema`);
 		const rawLimits = definition.limits;
 		assertLimit(rawLimits?.maxSteps, "maxSteps", 1, name);
@@ -498,6 +513,7 @@ function createComposition(config) {
 			...definition.toolChoice === void 0 ? {} : { toolChoice: typeof definition.toolChoice === "string" ? definition.toolChoice : { name: definition.toolChoice.name } },
 			...definition.elicitation === void 0 ? {} : { elicitation: definition.elicitation },
 			...definition.approvalMode === void 0 ? {} : { approvalMode: definition.approvalMode },
+			...definition.contextBudget === void 0 ? {} : { contextBudget: { ...definition.contextBudget } },
 			...definition.inputSchema === void 0 ? {} : { inputSchema: definition.inputSchema },
 			...definition.outputSchema === void 0 ? {} : { outputSchema: definition.outputSchema },
 			...rawLimits === void 0 ? {} : { limits: {
@@ -621,6 +637,11 @@ function createComposition(config) {
 		teams,
 		tools,
 		contextProviders,
+		contextBudget: config.contextBudget === void 0 ? void 0 : { ...config.contextBudget },
+		compaction: {
+			compactor: config.compaction?.compactor ?? createDigestContextCompactor(),
+			estimateTokens: config.compaction?.estimateTokens ?? estimateContextTokens
+		},
 		memoryStore: config.memoryStore ?? (usesMemory ? new InMemoryMemoryStore() : void 0),
 		runStore: config.runStore ?? new InMemoryRunStore(),
 		credentialStore: config.credentialStore,
@@ -778,6 +799,103 @@ const runErrorPayload = (error) => {
 	};
 };
 //#endregion
+//#region src/internal/context-compaction.ts
+/** Maximum summary characters copied into the context.compacted event. */
+const MAX_COMPACTION_EVENT_SUMMARY_CHARS = 4e3;
+async function compactContext(input) {
+	const estimateWith = (messages, includeTools) => {
+		const value = input.estimateTokens({
+			messages,
+			...includeTools ? { tools: input.tools } : {}
+		});
+		if (!Number.isFinite(value) || value < 0) throw new TypeError("Context token estimator must return a non-negative finite number");
+		return Math.ceil(value * input.contextBudget.safetyFactor);
+	};
+	const estimate = (messages) => estimateWith(messages, true);
+	const estimated = estimate(input.messages);
+	const usable = input.contextBudget.contextWindow - input.contextBudget.reserveOutputTokens;
+	const threshold = Math.floor(usable * input.contextBudget.compactAt);
+	if (input.allowCompaction === false || estimated <= threshold) {
+		if (estimated > usable) throw new FevexRunError("CONTEXT_BUDGET_EXCEEDED", `Agent "${input.agentName}" context budget exceeded: ${estimated} tokens > ${usable} usable${input.allowCompaction === false ? " after compaction" : ""}.`, input.runId);
+		return;
+	}
+	const split = splitContextForCompaction(input.messages);
+	if (split === void 0 || split.compactable.length === 0) {
+		if (estimated > usable) throw new FevexRunError("CONTEXT_BUDGET_EXCEEDED", `Agent "${input.agentName}" context budget exceeded: ${estimated} tokens > ${usable} usable. The preserved system prefix and current turn cannot be compacted further.`, input.runId);
+		return;
+	}
+	const preservedTokens = estimate([...split.prefix, ...split.currentTurn]);
+	const available = Math.max(1, Math.min(input.contextBudget.targetTokens, usable - 1) - preservedTokens);
+	const compactedMessages = validateCompactedMessages(await abortable(() => input.compactor.compact({
+		agentName: input.agentName,
+		sessionId: input.sessionId,
+		messages: split.compactable,
+		tools: input.tools,
+		estimatedTokens: estimated,
+		targetTokens: available,
+		contextWindow: input.contextBudget.contextWindow,
+		step: input.step,
+		...input.context === void 0 ? {} : { context: input.context },
+		signal: input.signal,
+		estimateTokens: (messages) => estimateWith(messages, false)
+	}), input.signal));
+	const messages = [
+		...split.prefix,
+		...compactedMessages,
+		...split.currentTurn
+	];
+	const compactedTokens = estimate(messages);
+	if (compactedTokens > usable) throw new FevexRunError("CONTEXT_BUDGET_EXCEEDED", `Agent "${input.agentName}" context budget exceeded after compaction: ${compactedTokens} tokens > ${usable} usable. The preserved system prefix and current turn cannot be compacted further.`, input.runId);
+	return {
+		messages,
+		removedMessages: split.compactable.length,
+		estimatedTokens: estimated,
+		compactedTokens,
+		summary: compactedMessages.map((message) => message.content).join("\n\n")
+	};
+}
+function splitContextForCompaction(messages) {
+	let lastUser = -1;
+	for (let index = messages.length - 1; index >= 0; index -= 1) if (messages[index].role === "user") {
+		lastUser = index;
+		break;
+	}
+	if (lastUser < 0) return void 0;
+	let lastToolBatch = -1;
+	for (let index = messages.length - 1; index > lastUser; index -= 1) {
+		const message = messages[index];
+		if (message.role === "assistant" && (message.toolCalls?.length ?? 0) > 0) {
+			lastToolBatch = index;
+			break;
+		}
+	}
+	const prefix = messages.filter((message) => message.role === "system");
+	const currentTurn = (lastToolBatch === -1 ? messages.slice(lastUser) : [messages[lastUser], ...messages.slice(lastToolBatch)]).filter((message) => message.role !== "system");
+	const preserved = /* @__PURE__ */ new Set([...prefix, ...currentTurn]);
+	return {
+		prefix,
+		currentTurn,
+		compactable: messages.filter((message) => message.role !== "system" && !preserved.has(message))
+	};
+}
+function validateCompactedMessages(value) {
+	if (!Array.isArray(value) || value.length === 0) throw new TypeError("Context compactor must return at least one message");
+	const roles = /* @__PURE__ */ new Set([
+		"system",
+		"user",
+		"assistant",
+		"tool"
+	]);
+	for (const [index, message] of value.entries()) {
+		if (typeof message !== "object" || message === null || Array.isArray(message)) throw new TypeError(`Context compactor message at index ${index} must be an object`);
+		const record = message;
+		if (typeof record.role !== "string" || !roles.has(record.role)) throw new TypeError(`Context compactor message at index ${index} has an invalid role`);
+		if (typeof record.content !== "string") throw new TypeError(`Context compactor message at index ${index} must have string content`);
+		if (record.toolCalls !== void 0 && !Array.isArray(record.toolCalls)) throw new TypeError(`Context compactor message at index ${index} has invalid toolCalls`);
+	}
+	return value;
+}
+//#endregion
 //#region src/internal/definition-hash.ts
 function canonicalize(value) {
 	if (Array.isArray(value)) return value.map(canonicalize);
@@ -804,7 +922,7 @@ async function sha256(value) {
 	const digest = await crypto.subtle.digest("SHA-256", encoded);
 	return Array.from(new Uint8Array(digest), (byte) => byte.toString(16).padStart(2, "0")).join("");
 }
-async function definitionHash(name, modelName, agent, tools) {
+async function definitionHash(name, modelName, agent, tools, contextBudget) {
 	const toolDefinitions = await Promise.all((agent.tools ?? []).map((toolName) => transportableTool(tools.get(toolName))));
 	return sha256({
 		name,
@@ -820,6 +938,7 @@ async function definitionHash(name, modelName, agent, tools) {
 		elicitation: agent.elicitation,
 		approvalMode: agent.approvalMode,
 		limits: agent.limits,
+		contextBudget,
 		inputSchema: agent.inputSchema === void 0 ? void 0 : toTransportableSchema(agent.inputSchema, "input", `Input schema for agent "${name}" is not transportable`),
 		outputSchema: agent.outputSchema === void 0 ? void 0 : toTransportableSchema(agent.outputSchema, "output", `Output schema for agent "${name}" is not transportable`)
 	});
@@ -904,12 +1023,13 @@ function addWorkflowBudget(first, second) {
 * engine — that direction is what keeps the two separable.
 */
 function createAgentEngine(composition, core) {
-	const { models, agents, tools, contextProviders, memoryStore, runStore, credentialStore, sandbox, artifacts, policies } = composition;
+	const { models, agents, tools, contextProviders, contextBudget: defaultContextBudget, compaction, memoryStore, runStore, credentialStore, sandbox, artifacts, policies } = composition;
 	const { activeRuns, activeSessions, runtimeOwner, isClosed, admitStart, markInternalRun, resolveModel, resolveCheckpointModel, notifyObserver, createEvent, emitEvent, releaseExecution, commit, startLease, cancelExecution, authorize } = core;
 	const prepareExecutionBody = async (name, request, internal = false, correlation = {}) => {
 		if (!internal && isClosed()) throw new FevexRunError("RUNTIME_CLOSED", "Runtime is not accepting new runs");
 		const agent = agents.get(name);
 		if (!agent) throw new FevexRunError("AGENT_NOT_FOUND", `Agent "${name}" is not registered`);
+		const contextBudget = resolveContextBudget(request.contextBudget ?? agent.contextBudget ?? defaultContextBudget, `Agent "${name}" contextBudget`);
 		const { modelName, model } = resolveModel(agent, request.model);
 		const now = (/* @__PURE__ */ new Date()).toISOString();
 		let session;
@@ -967,7 +1087,7 @@ function createAgentEngine(composition, core) {
 						content: agent.instructions
 					},
 					...knowledge.skills,
-					...session.history,
+					...sessionHistoryMessages(session),
 					...knowledge.context,
 					...knowledge.memory,
 					{
@@ -980,8 +1100,9 @@ function createAgentEngine(composition, core) {
 					runId: run.id,
 					...request.model !== void 0 || typeof agent.model === "string" ? { modelName } : {},
 					...request.reasoning === void 0 ? {} : { reasoning: request.reasoning },
-					definitionHash: await definitionHash(name, modelName, agent, tools),
+					definitionHash: await definitionHash(name, modelName, agent, tools, contextBudget),
 					limits: combineLimits(agent.limits, request.limits),
+					...contextBudget === void 0 ? {} : { contextBudget },
 					messages,
 					inputContent,
 					context: request.context,
@@ -1039,6 +1160,7 @@ function createAgentEngine(composition, core) {
 	const durableCheckpoint = async (state, model, modelName, messages, inputContent, usage, providerState, step, toolCallCount, seenToolCallIds, pendingTools, pendingIndex) => {
 		const agent = agents.get(state.run.agentName);
 		if (agent.model !== void 0 && typeof agent.model !== "string") throw new FevexRunError("RUN_NOT_RESUMABLE", "Durable continuation requires a named model", state.run.id);
+		const contextBudget = resolveContextBudget(state.checkpoint?.contextBudget ?? state.request.contextBudget ?? agent.contextBudget ?? defaultContextBudget, `Agent "${state.run.agentName}" contextBudget`);
 		let serializedState;
 		if (providerState !== void 0) {
 			if (!model.stateCodec) throw new FevexRunError("RUN_NOT_RESUMABLE", "ModelGateway must provide stateCodec for durable continuation", state.run.id);
@@ -1049,8 +1171,9 @@ function createAgentEngine(composition, core) {
 			runId: state.run.id,
 			modelName,
 			...state.request.reasoning === void 0 ? {} : { reasoning: state.request.reasoning },
-			definitionHash: await definitionHash(state.run.agentName, modelName, agent, tools),
+			definitionHash: await definitionHash(state.run.agentName, modelName, agent, tools, contextBudget),
 			limits: state.checkpoint?.limits ?? combineLimits(agent.limits, state.request.limits),
+			...contextBudget === void 0 ? {} : { contextBudget },
 			messages: structuredClone(messages),
 			inputContent,
 			context: state.request.context,
@@ -1109,6 +1232,7 @@ function createAgentEngine(composition, core) {
 		const { request } = state;
 		const agent = agents.get(name);
 		const { modelName, model } = resolveModel(agent, state.checkpoint?.modelName ?? request.model);
+		const contextBudget = resolveContextBudget(state.checkpoint?.contextBudget ?? request.contextBudget ?? agent.contextBudget ?? defaultContextBudget, `Agent "${name}" contextBudget`);
 		const events = [...state.initialEvents ?? []];
 		const firstEvents = state.initialEvents ?? [];
 		state.initialEvents = void 0;
@@ -1126,12 +1250,13 @@ function createAgentEngine(composition, core) {
 		let seenToolCallIds;
 		let pendingTools;
 		let pendingIndex;
+		let compactionApplied = false;
 		try {
 			for (const event of firstEvents) yield event;
 			if (state.checkpoint) {
 				const checkpoint = state.checkpoint;
 				if (checkpoint.version !== 2) throw new FevexRunError("CHECKPOINT_UNSUPPORTED", `Checkpoint for run "${state.run.id}" is unsupported`, state.run.id);
-				const hash = await definitionHash(name, modelName, agent, tools);
+				const hash = await definitionHash(name, modelName, agent, tools, contextBudget);
 				if (checkpoint.definitionHash !== hash) throw new FevexRunError("RUN_DEFINITION_CHANGED", `Definition for agent "${name}" changed`, state.run.id);
 				inputContent = checkpoint.inputContent;
 				messages = checkpoint.messages;
@@ -1153,7 +1278,7 @@ function createAgentEngine(composition, core) {
 						content: agent.instructions
 					},
 					...knowledge.skills,
-					...state.session.history,
+					...sessionHistoryMessages(state.session),
 					...knowledge.context,
 					...knowledge.memory,
 					{
@@ -1232,6 +1357,59 @@ function createAgentEngine(composition, core) {
 			while (step <= maxSteps) {
 				request.signal.throwIfAborted();
 				if (pendingTools.length === 0) {
+					if (contextBudget !== void 0) {
+						const compacted = await compactContext({
+							runId: state.run.id,
+							agentName: name,
+							sessionId: state.session.id,
+							messages,
+							tools: allTools,
+							contextBudget,
+							compactor: compaction.compactor,
+							estimateTokens: compaction.estimateTokens,
+							step,
+							...request.context === void 0 ? {} : { context: request.context },
+							signal: request.signal,
+							allowCompaction: !compactionApplied
+						});
+						if (compacted !== void 0) {
+							messages = compacted.messages;
+							compactionApplied = true;
+							const previous = state.session.compaction;
+							const combined = previous === void 0 ? compacted.summary : `${previous.summary}\n\n${compacted.summary}`;
+							const maxSummaryChars = Math.max(200, contextBudget.targetTokens * 4);
+							state.session.compaction = {
+								summary: combined.length > maxSummaryChars ? `…${combined.slice(combined.length - maxSummaryChars + 1)}` : combined,
+								coveredMessages: state.session.history.length,
+								updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+							};
+							const summaryTruncated = compacted.summary.length > MAX_COMPACTION_EVENT_SUMMARY_CHARS;
+							const event = createEvent(state, "context.compacted", {
+								step,
+								removedMessages: compacted.removedMessages,
+								estimatedTokens: compacted.estimatedTokens,
+								compactedTokens: compacted.compactedTokens,
+								targetTokens: contextBudget.targetTokens,
+								contextWindow: contextBudget.contextWindow,
+								summary: summaryTruncated ? `${compacted.summary.slice(0, MAX_COMPACTION_EVENT_SUMMARY_CHARS - 1)}…` : compacted.summary,
+								...summaryTruncated ? { summaryTruncated: true } : {}
+							});
+							if (isDurableRunStore(runStore)) {
+								const checkpoint = await durableCheckpoint(state, model, modelName, messages, inputContent, usage, providerState, step, toolCallCount, seenToolCallIds, pendingTools, pendingIndex);
+								await commit(state, {
+									checkpoint,
+									session: state.session,
+									events: [event]
+								});
+								state.checkpoint = checkpoint;
+							} else {
+								await runStore.appendEvent(event);
+								notifyObserver(event);
+							}
+							events.push(event);
+							yield event;
+						}
+					}
 					const hasToolBudget = step < maxSteps && toolCallCount < maxToolCalls;
 					const modelToolChoice = hasToolBudget && allTools.length ? currentToolChoice === "auto" ? void 0 : currentToolChoice : void 0;
 					yield await emit("model.started", { step });
@@ -2113,6 +2291,14 @@ function createAgentEngine(composition, core) {
 		cancelStoredAgent
 	};
 }
+function sessionHistoryMessages(session) {
+	const compaction = session.compaction;
+	if (compaction === void 0 || compaction.coveredMessages <= 0 || compaction.coveredMessages > session.history.length) return session.history;
+	return [{
+		role: "system",
+		content: `[Compacted conversation]\n${compaction.summary}`
+	}, ...session.history.slice(compaction.coveredMessages)];
+}
 function readSkillInput(input) {
 	if (typeof input !== "object" || input === null || Array.isArray(input)) throw new TypeError(`${LOAD_SKILL_TOOL_NAME} input must be an object`);
 	const record = input;
@@ -2284,6 +2470,17 @@ function annotation(event) {
 				delayMs: event.payload.delayMs
 			}
 		};
+		case "context.compacted": return {
+			name: event.type,
+			timestamp: event.timestamp,
+			attributes: {
+				removedMessages: event.payload.removedMessages,
+				estimatedTokens: event.payload.estimatedTokens,
+				compactedTokens: event.payload.compactedTokens,
+				targetTokens: event.payload.targetTokens,
+				contextWindow: event.payload.contextWindow
+			}
+		};
 		case "tool.execution_unknown": return {
 			name: event.type,
 			timestamp: event.timestamp,
@@ -2882,12 +3079,12 @@ function createRunCore({ models, agents, tools, runStore, policies, onEvent, obs
 	};
 	const resolveCheckpointModel = async (agentName, agent, checkpoint) => {
 		const preferred = resolveModel(agent, checkpoint.modelName);
-		if (checkpoint.definitionHash === await definitionHash(agentName, preferred.modelName, agent, tools)) return preferred;
+		if (checkpoint.definitionHash === await definitionHash(agentName, preferred.modelName, agent, tools, checkpoint.contextBudget)) return preferred;
 		if (checkpoint.modelName !== void 0) return void 0;
 		for (const candidateName of models.keys()) {
 			if (candidateName === preferred.modelName) continue;
 			const candidate = resolveModel(agent, candidateName);
-			if (checkpoint.definitionHash === await definitionHash(agentName, candidate.modelName, agent, tools)) return candidate;
+			if (checkpoint.definitionHash === await definitionHash(agentName, candidate.modelName, agent, tools, checkpoint.contextBudget)) return candidate;
 		}
 	};
 	const scheduleTraceExport = (event) => {
@@ -4408,6 +4605,7 @@ function createRuntime(composition) {
 				role: "system",
 				content: summary
 			}];
+			session.compaction = void 0;
 			session.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
 			await runStore.saveSession(session);
 			return structuredClone(session);
@@ -4433,4 +4631,4 @@ function createFevex(config) {
 	return createRuntime(createComposition(config));
 }
 //#endregion
-export { ArtifactError, CatalogedArtifactStore, ChannelError, FEVEX_JSON_SCHEMA_PROFILE_VERSION, FevexConfigurationError, FevexRunError, FileSystemArtifactStore, InMemoryArtifactCatalog, InMemoryArtifactStore, InMemoryMemoryStore, InMemoryRunStore, IntegrationError, PROVIDER_REASONING_UNSUPPORTED, PROVIDER_SCHEMA_UNSUPPORTED, RunPausedError, S3ArtifactStore, SCHEMA_NOT_TRANSPORTABLE, SandboxError, artifactTenantId, assertArtifactId, compileFevexJsonSchema, createAgentsMdContextProvider, createFevex, createLocalSandbox, createMemoryContextProvider, defineAgent, defineConnection, defineContextProvider, definePolicy, defineSkill, defineTeam, defineTool, defineWorkflow, deliverChannelRun, handleChannelInput, isDurableRunStore, isProgressiveSkillProvider, isRetainableRunStore, loadSkillFile, loadSkillFiles, sandboxResultToJson, toToolSpec, validateFevexJsonSchemaProfile, validateListEventsOptions, validatePurgeRunsOptions };
+export { ArtifactError, CatalogedArtifactStore, ChannelError, FEVEX_JSON_SCHEMA_PROFILE_VERSION, FevexConfigurationError, FevexRunError, FileSystemArtifactStore, InMemoryArtifactCatalog, InMemoryArtifactStore, InMemoryMemoryStore, InMemoryRunStore, IntegrationError, PROVIDER_REASONING_UNSUPPORTED, PROVIDER_SCHEMA_UNSUPPORTED, RunPausedError, S3ArtifactStore, SCHEMA_NOT_TRANSPORTABLE, SandboxError, artifactTenantId, assertArtifactId, compileFevexJsonSchema, createAgentsMdContextProvider, createDigestContextCompactor, createFevex, createLocalSandbox, createMemoryContextProvider, defineAgent, defineConnection, defineContextProvider, definePolicy, defineSkill, defineTeam, defineTool, defineWorkflow, deliverChannelRun, estimateContextTokens, handleChannelInput, isDurableRunStore, isProgressiveSkillProvider, isRetainableRunStore, loadSkillFile, loadSkillFiles, resolveContextBudget, sandboxResultToJson, toToolSpec, validateFevexJsonSchemaProfile, validateListEventsOptions, validatePurgeRunsOptions };

package/dist/knowledge/index.d.mts

@@ -1,2 +1,2 @@
-import { _ as defineContextProvider, a as AgentsMdOptions, c as ContextProvider, d as MemoryRecord, f as MemoryStore, g as createMemoryContextProvider, h as SkillDefinition, i as InMemoryMemoryStore, l as KnowledgeContext, m as ProgressiveSkillProvider, n as loadSkillFile, o as createAgentsMdContextProvider, p as MemoryWrite, r as loadSkillFiles, s as ContextBlock, t as LoadSkillFileOptions, u as MemoryQuery, v as defineSkill, y as isProgressiveSkillProvider } from "../index-B0AdFbgr.mjs";
+import { _ as defineContextProvider, a as AgentsMdOptions, c as ContextProvider, d as MemoryRecord, f as MemoryStore, g as createMemoryContextProvider, h as SkillDefinition, i as InMemoryMemoryStore, l as KnowledgeContext, m as ProgressiveSkillProvider, n as loadSkillFile, o as createAgentsMdContextProvider, p as MemoryWrite, r as loadSkillFiles, s as ContextBlock, t as LoadSkillFileOptions, u as MemoryQuery, v as defineSkill, y as isProgressiveSkillProvider } from "../index-CAyAoOW0.mjs";
 export { AgentsMdOptions, ContextBlock, ContextProvider, InMemoryMemoryStore, KnowledgeContext, LoadSkillFileOptions, MemoryQuery, MemoryRecord, MemoryStore, MemoryWrite, ProgressiveSkillProvider, SkillDefinition, createAgentsMdContextProvider, createMemoryContextProvider, defineContextProvider, defineSkill, isProgressiveSkillProvider, loadSkillFile, loadSkillFiles };

package/dist/models/index.d.mts

@@ -1,2 +1,2 @@
-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-BgKFd9yw.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-BfYzemR8.mjs";
 export { ModelGateway, ModelInput, ModelMetadata, ModelRef, ModelResult, ModelStreamEvent, ModelUsage, ReasoningEffort, ToolChoice };

package/dist/observability/index.d.mts

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

package/dist/policies/index.d.mts

@@ -1,2 +1,2 @@
-import { i as definePolicy, n as PolicyDecision, r as PolicyDefinition, t as PolicyAuthorization } from "../index-CbACw6xZ.mjs";
+import { i as definePolicy, n as PolicyDecision, r as PolicyDefinition, t as PolicyAuthorization } from "../index-Bl0hR7EC.mjs";
 export { PolicyAuthorization, PolicyDecision, PolicyDefinition, definePolicy };

package/dist/runtime/index.d.mts

@@ -1,2 +1,2 @@
-import { $ as validateListEventsOptions, A as RunPause, B as TeamRun, C as PurgeRunsResult, D as RunCheckpoint, E as RetainableRunStore, F as RunStore, G as WorkflowBudgetUsage, H as ToolExecutionRecord, I as Session, J as WorkflowRun, K as WorkflowCheckpoint, L as SessionId, M as RunRequest, N as RunResult, O as RunCorrelation, P as RunStatus, Q as isRetainableRunStore, R as StoredRunCheckpoint, S as PurgeRunsOptions, T as RetainableRunStatus, U as ToolExecutionResolution, V as TimerResolution, W as ToolExecutionStatus, X as WorkflowWaitRecord, Y as WorkflowStepRecord, Z as isDurableRunStore, _ as EventResolution, a as AgentRun, b as ListEventsOptions, c as ApprovalRequest, d as CoordinatorRun, et as validatePurgeRunsOptions, f as CredentialStore, g as ElicitationResolution, h as ElicitationRequest, i as InMemoryRunStore, j as RunRecord, k as RunLease, l as ApprovalResolution, m as ElicitationMode, o as AgentRunPause, p as DurableRunStore, q as WorkflowCompensationRecord, s as ApprovalMode, u as CoordinatorCheckpoint, v as ExecutionCommit, w as ResumeRunResolution, x as PendingToolExecution, y as ExecutionCreate, z as TeamCheckpoint } from "../index-CzAi2Y_Z.mjs";
-export { AgentRun, AgentRunPause, ApprovalMode, ApprovalRequest, ApprovalResolution, CoordinatorCheckpoint, CoordinatorRun, CredentialStore, DurableRunStore, ElicitationMode, ElicitationRequest, ElicitationResolution, EventResolution, ExecutionCommit, ExecutionCreate, InMemoryRunStore, ListEventsOptions, PendingToolExecution, PurgeRunsOptions, PurgeRunsResult, ResumeRunResolution, RetainableRunStatus, RetainableRunStore, RunCheckpoint, RunCorrelation, RunLease, RunPause, RunRecord, RunRequest, RunResult, RunStatus, RunStore, Session, SessionId, StoredRunCheckpoint, TeamCheckpoint, TeamRun, TimerResolution, ToolExecutionRecord, ToolExecutionResolution, ToolExecutionStatus, WorkflowBudgetUsage, WorkflowCheckpoint, WorkflowCompensationRecord, WorkflowRun, WorkflowStepRecord, WorkflowWaitRecord, isDurableRunStore, isRetainableRunStore, validateListEventsOptions, validatePurgeRunsOptions };
+import { $ as ToolExecutionRecord, A as ListEventsOptions, B as RunPause, C as DurableRunStore, D as EventResolution, E as ElicitationResolution, F as RetainableRunStatus, G as RunStore, H as RunRequest, I as RetainableRunStore, J as SessionId, K as Session, L as RunCheckpoint, M as PurgeRunsOptions, N as PurgeRunsResult, O as ExecutionCommit, P as ResumeRunResolution, Q as TimerResolution, R as RunCorrelation, S as CredentialStore, T as ElicitationRequest, U as RunResult, V as RunRecord, W as RunStatus, X as TeamCheckpoint, Y as StoredRunCheckpoint, Z as TeamRun, _ as ApprovalMode, a as InMemoryRunStore, at as WorkflowRun, b as CoordinatorCheckpoint, c as ContextCompactor, ct as isDurableRunStore, d as ResolvedContextBudget, dt as validatePurgeRunsOptions, et as ToolExecutionResolution, f as createDigestContextCompactor, g as AgentRunPause, h as AgentRun, it as WorkflowCompensationRecord, j as PendingToolExecution, k as ExecutionCreate, l as ContextTokenEstimator, lt as isRetainableRunStore, m as resolveContextBudget, nt as WorkflowBudgetUsage, o as ContextCompactionInput, ot as WorkflowStepRecord, p as estimateContextTokens, q as SessionCompaction, rt as WorkflowCheckpoint, s as ContextCompactionOptions, st as WorkflowWaitRecord, tt as ToolExecutionStatus, u as DigestContextCompactorOptions, ut as validateListEventsOptions, v as ApprovalRequest, w as ElicitationMode, x as CoordinatorRun, y as ApprovalResolution, z as RunLease } from "../index-B8molngu.mjs";
+export { AgentRun, AgentRunPause, ApprovalMode, ApprovalRequest, ApprovalResolution, ContextCompactionInput, ContextCompactionOptions, ContextCompactor, ContextTokenEstimator, CoordinatorCheckpoint, CoordinatorRun, CredentialStore, DigestContextCompactorOptions, DurableRunStore, ElicitationMode, ElicitationRequest, ElicitationResolution, EventResolution, ExecutionCommit, ExecutionCreate, InMemoryRunStore, ListEventsOptions, PendingToolExecution, PurgeRunsOptions, PurgeRunsResult, ResolvedContextBudget, ResumeRunResolution, RetainableRunStatus, RetainableRunStore, RunCheckpoint, RunCorrelation, RunLease, RunPause, RunRecord, RunRequest, RunResult, RunStatus, RunStore, Session, SessionCompaction, SessionId, StoredRunCheckpoint, TeamCheckpoint, TeamRun, TimerResolution, ToolExecutionRecord, ToolExecutionResolution, ToolExecutionStatus, WorkflowBudgetUsage, WorkflowCheckpoint, WorkflowCompensationRecord, WorkflowRun, WorkflowStepRecord, WorkflowWaitRecord, createDigestContextCompactor, estimateContextTokens, isDurableRunStore, isRetainableRunStore, resolveContextBudget, validateListEventsOptions, validatePurgeRunsOptions };

package/dist/runtime/index.mjs

@@ -1,4 +1,108 @@
 import { t as FevexRunError } from "../run-error-Cr17wPGH.mjs";
+//#region src/runtime/compaction.ts
+/** Validates a context budget and fills in defaults. */
+function resolveContextBudget(budget, label) {
+	if (budget === void 0) return void 0;
+	if (!isRecord(budget)) throw new TypeError(`${label} must be an object`);
+	const contextWindow = budget.contextWindow;
+	if (!Number.isSafeInteger(contextWindow) || contextWindow <= 0) throw new TypeError(`${label}.contextWindow must be a positive safe integer`);
+	const reserveOutputTokens = budget.reserveOutputTokens ?? 0;
+	if (!Number.isSafeInteger(reserveOutputTokens) || reserveOutputTokens < 0 || reserveOutputTokens >= contextWindow) throw new TypeError(`${label}.reserveOutputTokens must be a non-negative safe integer below contextWindow`);
+	const usable = contextWindow - reserveOutputTokens;
+	const compactAt = budget.compactAt ?? .8;
+	if (typeof compactAt !== "number" || !Number.isFinite(compactAt) || compactAt <= 0 || compactAt > 1) throw new TypeError(`${label}.compactAt must be greater than 0 and at most 1`);
+	const targetTokens = budget.targetTokens ?? Math.max(1, Math.floor(usable * Math.min(.5, compactAt * .9)));
+	if (!Number.isSafeInteger(targetTokens) || targetTokens <= 0 || targetTokens >= usable) throw new TypeError(`${label}.targetTokens must be a positive safe integer below the usable window`);
+	if (targetTokens > Math.floor(usable * compactAt)) throw new TypeError(`${label}.targetTokens must not exceed the compaction threshold`);
+	const safetyFactor = budget.safetyFactor ?? 1.1;
+	if (typeof safetyFactor !== "number" || !Number.isFinite(safetyFactor) || safetyFactor < 1 || safetyFactor > 2) throw new TypeError(`${label}.safetyFactor must be between 1 and 2`);
+	return {
+		contextWindow,
+		reserveOutputTokens,
+		compactAt,
+		targetTokens,
+		safetyFactor
+	};
+}
+/**
+* Rough provider-neutral estimate: about four characters per token plus
+* message and tool framing. Hosts can inject a real tokenizer instead.
+*/
+function estimateContextTokens(input) {
+	let characters = 0;
+	for (const message of input.messages) {
+		characters += message.role.length + message.content.length + 16;
+		if (message.name !== void 0) characters += message.name.length;
+		if (message.toolCallId !== void 0) characters += message.toolCallId.length;
+		if (message.toolCalls !== void 0) characters += JSON.stringify(message.toolCalls).length;
+	}
+	if (input.tools?.length) characters += JSON.stringify(input.tools).length;
+	return Math.max(1, Math.ceil(characters / 4));
+}
+/**
+* Deterministic compactor used when the host does not inject one. It keeps
+* role-aware excerpts of older messages and drops the oldest excerpts first.
+* It never calls a model.
+*/
+function createDigestContextCompactor(options = {}) {
+	const maxChars = options.maxCharsPerMessage ?? 400;
+	if (!Number.isSafeInteger(maxChars) || maxChars < 40) throw new TypeError("Digest compactor maxCharsPerMessage must be a safe integer of at least 40");
+	return { compact(input) {
+		if (input.messages.length === 0) return [{
+			role: "system",
+			content: "[Compacted earlier conversation]"
+		}];
+		let perMessage = maxChars;
+		let lines = input.messages.flatMap((message) => digestMessage(message, perMessage));
+		while (input.estimateTokens([{
+			role: "system",
+			content: digestContent(lines, input.messages.length)
+		}]) > input.targetTokens && perMessage > 40) {
+			perMessage = Math.max(40, Math.floor(perMessage * .7));
+			lines = input.messages.flatMap((message) => digestMessage(message, perMessage));
+		}
+		let selected = lines;
+		let content = digestContent(selected, input.messages.length);
+		while (input.estimateTokens([{
+			role: "system",
+			content
+		}]) > input.targetTokens && selected.length > 1) {
+			selected = selected.slice(1);
+			content = digestContent(selected, input.messages.length);
+		}
+		const limit = Math.max(80, input.targetTokens * 4);
+		if (content.length > limit) content = `${content.slice(0, Math.max(0, limit - 1))}…`;
+		return [{
+			role: "system",
+			content
+		}];
+	} };
+}
+function digestContent(lines, totalMessages) {
+	const omitted = Math.max(0, totalMessages - lines.length);
+	return [`[Compacted conversation: ${totalMessages} earlier messages${omitted ? `, ${omitted} omitted` : ""}]`, ...lines].join("\n");
+}
+function digestMessage(message, maxChars) {
+	const content = truncate(message.content, maxChars);
+	if (message.role === "user") return content ? [`User: ${content}`] : [];
+	if (message.role === "assistant") {
+		const lines = [];
+		if (content) lines.push(`Assistant: ${content}`);
+		for (const call of message.toolCalls ?? []) lines.push(`Tool call ${call.name}: ${truncate(JSON.stringify(call.input), Math.min(maxChars, 200))}`);
+		return lines;
+	}
+	if (message.role === "tool") return content ? [`Tool result${message.name === void 0 ? "" : ` (${message.name})`}: ${content}`] : [];
+	return content ? [`System: ${content}`] : [];
+}
+function truncate(value, maxChars) {
+	const normalized = value.replace(/\s+/g, " ").trim();
+	if (normalized.length <= maxChars) return normalized;
+	return `${normalized.slice(0, Math.max(0, maxChars - 1))}…`;
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//#endregion
 //#region src/runtime/run-store.ts
 function validateListEventsOptions(options) {
 	if (options.limit !== void 0 && (!Number.isSafeInteger(options.limit) || options.limit < 1)) throw new TypeError("Event limit must be a positive safe integer");
@@ -180,4 +284,4 @@ var InMemoryRunStore = class {
 	}
 };
 //#endregion
-export { InMemoryRunStore, isDurableRunStore, isRetainableRunStore, validateListEventsOptions, validatePurgeRunsOptions };
+export { InMemoryRunStore, createDigestContextCompactor, estimateContextTokens, isDurableRunStore, isRetainableRunStore, resolveContextBudget, validateListEventsOptions, validatePurgeRunsOptions };

package/dist/sandbox/index.d.mts

@@ -1,2 +1,2 @@
-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-Df84VWmN.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-CL7mu_x9.mjs";
 export { LocalSandboxOptions, Sandbox, SandboxCapabilities, SandboxError, SandboxRunRequest, SandboxRunResult, createLocalSandbox, sandboxResultToJson };

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-1cHr7KB_.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-CODYPevS.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-B8laW1hM.mjs";
-import { a as ModelResult, n as ModelInput, t as ModelGateway } from "../index-BgKFd9yw.mjs";
-import { h as ElicitationRequest, p as DurableRunStore } from "../index-CzAi2Y_Z.mjs";
-import { f as MemoryStore } from "../index-B0AdFbgr.mjs";
-import { d as ToolProvider } from "../index-5p3q2yIp.mjs";
-import { d as ChannelMessage, f as ChannelOutput, o as ChannelElicitationContext, r as ChannelAdapter } from "../index-BTD1c4Ys.mjs";
+import { m as ToolCall } from "../types-CckDlhYo.mjs";
+import { a as ModelResult, n as ModelInput, t as ModelGateway } from "../index-BfYzemR8.mjs";
+import { C as DurableRunStore, T as ElicitationRequest } from "../index-B8molngu.mjs";
+import { f as MemoryStore } from "../index-CAyAoOW0.mjs";
+import { d as ToolProvider } from "../index-DtMxzCqj.mjs";
+import { d as ChannelMessage, f as ChannelOutput, o as ChannelElicitationContext, r as ChannelAdapter } from "../index-CuaetTLQ.mjs";
 //#region src/testing/contracts.d.ts
 interface ModelGatewayContract {
   output?: unknown;

package/dist/tools/index.d.mts

@@ -1,3 +1,3 @@
-import { g as ToolSpec, m as ToolCall } from "../types-B8laW1hM.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-5p3q2yIp.mjs";
+import { g as ToolSpec, m as ToolCall } from "../types-CckDlhYo.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-DtMxzCqj.mjs";
 export { ConnectionDefinition, ConnectionToolPolicy, FEVEX_JSON_SCHEMA_PROFILE_VERSION, FevexJsonSchemaProfileLimits, FevexJsonSchemaProfileOptions, FevexJsonSchemaValidator, IntegrationError, IntegrationErrorCategory, ToolApproval, type ToolCall, ToolDefinition, ToolExecutionContext, ToolIdempotency, ToolProvider, ToolProviderContext, ToolProviderTool, ToolResult, ToolRetryPolicy, ToolRisk, type ToolSpec, compileFevexJsonSchema, defineConnection, defineTool, toToolSpec, validateFevexJsonSchemaProfile };

package/dist/{types-B8laW1hM.d.mts → types-CckDlhYo.d.mts}

@@ -258,7 +258,7 @@ interface ToolEventSource {
   connectionName: string;
   remoteToolName: string;
 }
-type AgentEventType = 'run.started' | 'run.recovered' | 'run.paused' | 'run.resumed' | 'model.started' | 'model.output.delta' | 'model.completed' | 'tool.started' | 'tool.completed' | 'tool.failed' | 'tool.retrying' | 'tool.execution_unknown' | 'artifact.created' | 'elicitation.requested' | 'elicitation.resolved' | 'approval.requested' | 'approval.resolved' | 'run.completed' | 'run.failed' | 'run.cancelled' | 'workflow.run.started' | 'workflow.run.recovered' | 'workflow.step.started' | 'workflow.step.completed' | 'workflow.step.failed' | 'workflow.compensation.started' | 'workflow.compensation.completed' | 'workflow.compensation.failed' | 'workflow.wait.started' | 'workflow.wait.completed' | 'workflow.run.paused' | 'workflow.run.resumed' | 'workflow.run.completed' | 'workflow.run.failed' | 'workflow.run.cancelled' | 'team.run.started' | 'team.run.recovered' | 'team.agent.assigned' | 'team.handoff.created' | 'team.task.completed' | 'team.task.failed' | 'team.merge.started' | 'team.merge.completed' | 'team.merge.failed' | 'team.run.paused' | 'team.run.resumed' | 'team.run.completed' | 'team.run.failed' | 'team.run.cancelled';
+type AgentEventType = 'run.started' | 'run.recovered' | 'run.paused' | 'run.resumed' | 'model.started' | 'model.output.delta' | 'model.completed' | 'context.compacted' | 'tool.started' | 'tool.completed' | 'tool.failed' | 'tool.retrying' | 'tool.execution_unknown' | 'artifact.created' | 'elicitation.requested' | 'elicitation.resolved' | 'approval.requested' | 'approval.resolved' | 'run.completed' | 'run.failed' | 'run.cancelled' | 'workflow.run.started' | 'workflow.run.recovered' | 'workflow.step.started' | 'workflow.step.completed' | 'workflow.step.failed' | 'workflow.compensation.started' | 'workflow.compensation.completed' | 'workflow.compensation.failed' | 'workflow.wait.started' | 'workflow.wait.completed' | 'workflow.run.paused' | 'workflow.run.resumed' | 'workflow.run.completed' | 'workflow.run.failed' | 'workflow.run.cancelled' | 'team.run.started' | 'team.run.recovered' | 'team.agent.assigned' | 'team.handoff.created' | 'team.task.completed' | 'team.task.failed' | 'team.merge.started' | 'team.merge.completed' | 'team.merge.failed' | 'team.run.paused' | 'team.run.resumed' | 'team.run.completed' | 'team.run.failed' | 'team.run.cancelled';
 interface AgentEventPayloads {
   'run.started': undefined;
   'run.recovered': {
@@ -292,6 +292,20 @@ interface AgentEventPayloads {
     teamDelegationId?: string;
     teamAgentName?: string;
   };
+  'context.compacted': {
+    step: number;
+    removedMessages: number;
+    estimatedTokens: number;
+    compactedTokens: number;
+    targetTokens: number;
+    contextWindow: number;
+    summary: string;
+    summaryTruncated?: boolean;
+    workflowStepId?: string;
+    workflowAgentName?: string;
+    teamDelegationId?: string;
+    teamAgentName?: string;
+  };
   'tool.started': {
     step: number;
     toolCallId: string;

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-CseuTR-F.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-RKE3-CKs.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.7",
+  "version": "0.1.0-alpha.8",
   "description": "Agent Engineering Framework for code-first, provider-neutral AI agents.",
   "type": "module",
   "license": "Apache-2.0",