@fevex/core 0.1.0-alpha.1 → 0.1.0-alpha.10

package/dist/index-lCCFokc6.d.mts

@@ -0,0 +1,617 @@
+import { o as ToolEmbeddingCache, t as ToolReranker, z as ExactDefinition } from "./index-DHcfIfh-.mjs";
+import { c as ReasoningEffort, i as ModelRef, l as ToolChoice, r as ModelMetadata, s as ModelUsage, t as ModelGateway, u as EmbeddingModel } from "./index-D7r0puBi.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 { StandardSchemaV1 } from "@standard-schema/spec";
+//#region src/runtime/run-store.d.ts
+/** Stable identifier for conversation history shared across runs. */
+type SessionId = string;
+type RunStatus = 'running' | 'paused' | 'completed' | 'failed' | 'cancelled';
+interface ApprovalRequest {
+  id: string;
+  toolCallId: string;
+  toolName: string;
+  toolLabel?: string;
+  input: JsonValue;
+  risk: 'read' | 'write' | 'sensitive' | 'destructive';
+  requestedAt: string;
+}
+type ElicitationMode = 'pause' | 'forbid';
+type ApprovalMode = 'pause' | 'deny';
+interface ElicitationRequest {
+  id: string;
+  toolCallId: string;
+  prompt: string;
+  responseSchema: JsonObject;
+  requestedAt: string;
+  expiresAt?: string;
+}
+type AgentRunPause = {
+  type: 'elicitation';
+  request: ElicitationRequest;
+} | {
+  type: 'approval';
+  approval: ApprovalRequest;
+} | {
+  type: 'tool_execution_unknown';
+  toolCallId: string;
+  toolName: string;
+  input: JsonValue;
+};
+type RunPause = AgentRunPause | {
+  type: 'workflow_child';
+  childRunId: RunId;
+  childPause: AgentRunPause;
+} | {
+  type: 'workflow_children';
+  children: Array<{
+    stepId: string;
+    childRunId: RunId;
+    childPause: AgentRunPause;
+  }>;
+} | {
+  type: 'workflow_timer';
+  stepId: string;
+  resumeAt: string;
+} | {
+  type: 'workflow_event';
+  stepId: string;
+  eventName: string;
+};
+interface ApprovalResolution {
+  type: 'approval';
+  approvalId: string;
+  decision: 'approve' | 'reject';
+  actor: {
+    id: string;
+    type?: string;
+  };
+}
+interface ElicitationResolution {
+  type: 'elicitation';
+  requestId: string;
+  value: JsonValue;
+  actor: {
+    id: string;
+    type?: string;
+  };
+}
+type ToolExecutionResolution = {
+  type: 'tool_execution';
+  toolCallId: string;
+  decision: 'use_output';
+  output: JsonValue;
+  actor: {
+    id: string;
+    type?: string;
+  };
+} | {
+  type: 'tool_execution';
+  toolCallId: string;
+  decision: 'retry';
+  actor: {
+    id: string;
+    type?: string;
+  };
+};
+type TimerResolution = {
+  type: 'timer';
+  actor?: {
+    id: string;
+    type?: string;
+  };
+};
+type EventResolution = {
+  type: 'event';
+  eventName: string;
+  payload?: JsonValue;
+  actor?: {
+    id: string;
+    type?: string;
+  };
+};
+type ResumeRunResolution = ElicitationResolution | ApprovalResolution | ToolExecutionResolution | TimerResolution | EventResolution;
+/** Correlation fields for runs created by a workflow or team coordinator. */
+interface RunCorrelation {
+  /** Run that created this one. */
+  parentRunId?: RunId;
+  /** Top-level run in the correlation tree. */
+  rootRunId?: RunId;
+}
+interface AgentRun<TOutput = JsonValue> extends RunCorrelation {
+  kind?: 'agent';
+  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;
+  createdAt: string;
+  updatedAt: string;
+  /** Absolute deadline for the run, derived from `RunRequest.deadlineMs`. */
+  deadlineAt?: string;
+  output?: TOutput;
+  error?: string;
+  usage?: ModelUsage;
+}
+interface WorkflowRun<TOutput = JsonValue> extends RunCorrelation {
+  kind: 'workflow';
+  id: RunId;
+  sessionId: SessionId;
+  workflowName: string;
+  status: RunStatus;
+  revision: number;
+  pause?: RunPause;
+  createdAt: string;
+  updatedAt: string;
+  /** Absolute deadline for the run, derived from `RunRequest.deadlineMs`. */
+  deadlineAt?: string;
+  output?: TOutput;
+  error?: string;
+  usage?: ModelUsage;
+}
+interface TeamRun<TOutput = JsonValue> extends RunCorrelation {
+  kind: 'team';
+  id: RunId;
+  sessionId: SessionId;
+  teamName: string;
+  status: RunStatus;
+  revision: number;
+  pause?: RunPause;
+  createdAt: string;
+  updatedAt: string;
+  /** Absolute deadline for the run, derived from `RunRequest.deadlineMs`. */
+  deadlineAt?: string;
+  output?: TOutput;
+  error?: string;
+  usage?: ModelUsage;
+}
+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;
+}
+interface ListEventsOptions {
+  after?: AgentEvent['id'];
+  /** Maximum results; omitted preserves the complete result for existing consumers. */
+  limit?: number;
+  /** Sequence order. Use descending with limit: 1 for the latest event. */
+  order?: 'asc' | 'desc';
+}
+declare function validateListEventsOptions(options: ListEventsOptions): void;
+type RetainableRunStatus = 'completed' | 'failed' | 'cancelled';
+interface PurgeRunsOptions {
+  /** Delete runs created strictly before this ISO timestamp. */
+  before?: string;
+  /** Terminal statuses to delete. Defaults to completed, failed and cancelled. */
+  statuses?: RetainableRunStatus[];
+  /** Maximum runs to delete in one call. */
+  limit?: number;
+}
+interface PurgeRunsResult {
+  runs: number;
+  sessions: number;
+}
+/** Optional capability for stores that can delete terminal runs and empty sessions. */
+interface RetainableRunStore extends RunStore {
+  purgeRuns(options?: PurgeRunsOptions): Promise<PurgeRunsResult>;
+}
+declare function isRetainableRunStore(store: RunStore): store is RetainableRunStore;
+declare function validatePurgeRunsOptions(options?: PurgeRunsOptions): {
+  statuses: RetainableRunStatus[];
+  before?: string;
+  limit?: number;
+};
+interface RunStore {
+  getRun<TRun extends RunRecord<unknown> = AgentRun>(runId: RunId): Promise<TRun | undefined>;
+  saveRun(run: RunRecord): Promise<void>;
+  getSession(sessionId: SessionId): Promise<Session | undefined>;
+  /** Compare and advance revision; reject active/paused sessions and stale snapshots. */
+  saveSession(session: Session): Promise<void>;
+  appendEvent(event: AgentEvent): Promise<void>;
+  listEvents(runId: RunId, options?: ListEventsOptions): Promise<AgentEvent[]>;
+}
+interface CredentialStore {
+  resolve(input: {
+    name: string;
+    namespace?: string;
+    actor?: {
+      id: string;
+      type?: string;
+    };
+  }): Promise<string | undefined>;
+}
+interface PendingToolExecution {
+  call: {
+    id: string;
+    name: string;
+    input: JsonValue;
+  };
+  input: JsonValue;
+  idempotencyKey: string;
+  attempt: number;
+}
+interface RunCheckpoint {
+  version: 2;
+  kind?: 'agent';
+  runId: RunId;
+  modelName?: string;
+  reasoning?: ReasoningEffort;
+  definitionHash: string;
+  limits?: AgentLimits;
+  contextBudget?: ContextBudget;
+  toolSearch?: ToolSearchCheckpointOptions;
+  loadedTools?: string[];
+  messages: AgentMessage[];
+  inputContent: string;
+  context?: ExecutionContext;
+  usage?: ModelUsage;
+  providerState?: JsonValue;
+  step: number;
+  toolCallCount: number;
+  seenToolCallIds: string[];
+  pendingTools: PendingToolExecution[];
+  pendingIndex: number;
+  effectiveElicitationMode?: ElicitationMode;
+  effectiveApprovalMode?: ApprovalMode;
+  effectiveToolChoice?: ToolChoice;
+}
+type WorkflowStepRecord = {
+  type: 'agent';
+  status: 'running';
+  agentName: string;
+  childRunId: RunId;
+  metadata?: JsonObject;
+} | {
+  type: 'agent';
+  status: 'completed';
+  agentName: string;
+  childRunId: RunId;
+  result: RunResult<JsonValue>;
+  compensation?: WorkflowCompensationRecord;
+  metadata?: JsonObject;
+} | {
+  type: 'parallel';
+  status: 'running';
+  metadata?: JsonObject;
+} | {
+  type: 'parallel';
+  status: 'completed';
+  result: JsonObject;
+  compensation?: WorkflowCompensationRecord;
+  metadata?: JsonObject;
+} | {
+  type: 'wait';
+  status: 'running';
+  wait: WorkflowWaitRecord;
+} | {
+  type: 'wait';
+  status: 'completed';
+  wait: WorkflowWaitRecord;
+  payload?: JsonValue;
+  actor?: NonNullable<ExecutionContext['actor']>;
+  receivedAt?: string;
+};
+interface WorkflowCompensationRecord {
+  status: 'pending' | 'completed' | 'failed';
+  error?: string;
+}
+type WorkflowWaitRecord = {
+  type: 'timer';
+  resumeAt: string;
+} | {
+  type: 'event';
+  eventName: string;
+  requireActor: boolean;
+};
+interface WorkflowBudgetUsage {
+  usage?: ModelUsage;
+  steps: number;
+  toolCalls: number;
+}
+interface WorkflowCheckpoint {
+  version: 2;
+  kind: 'workflow';
+  runId: RunId;
+  workflowName: string;
+  model?: string;
+  reasoning?: ReasoningEffort;
+  definitionHash: string;
+  input: JsonValue;
+  context?: ExecutionContext;
+  steps: Record<string, WorkflowStepRecord>;
+  limits?: AgentLimits;
+  budget?: WorkflowBudgetUsage;
+}
+interface TeamCheckpoint extends Omit<WorkflowCheckpoint, 'kind' | 'workflowName'> {
+  kind: 'team';
+  teamName: string;
+}
+type CoordinatorCheckpoint = WorkflowCheckpoint | TeamCheckpoint;
+type StoredRunCheckpoint = RunCheckpoint | WorkflowCheckpoint | TeamCheckpoint;
+type ToolExecutionStatus = 'started' | 'completed' | 'failed' | 'unknown';
+interface ToolExecutionRecord {
+  runId: RunId;
+  toolCallId: string;
+  toolName: string;
+  input: JsonValue;
+  status: ToolExecutionStatus;
+  attempt: number;
+  idempotencyKey: string;
+  output?: JsonValue;
+  error?: string;
+  updatedAt: string;
+}
+/** Store assigns a new generation on creation/acquisition; callers must retain it. */
+interface RunLease {
+  generation: number;
+  runId: RunId;
+  ownerId: string;
+  expiresAt: string;
+}
+interface ExecutionCommit {
+  /** Current lease identity; ownership, generation and expiry are checked atomically. */
+  lease: Pick<RunLease, 'ownerId' | 'generation'>;
+  expectedRevision: number;
+  run: RunRecord;
+  checkpoint?: StoredRunCheckpoint | null;
+  session?: Session;
+  toolExecution?: ToolExecutionRecord;
+  events?: AgentEvent[];
+}
+/** Atomically reserve the session until this run is terminal, including across pause/crash. */
+interface ExecutionCreate {
+  run: RunRecord;
+  checkpoint: StoredRunCheckpoint;
+  /** Snapshot used to prepare the run; revision must match the stored history. */
+  session: Session;
+  lease: RunLease;
+  events: AgentEvent[];
+}
+interface DurableRunStore extends RunStore {
+  getCheckpoint<TCheckpoint extends StoredRunCheckpoint = RunCheckpoint>(runId: RunId): Promise<TCheckpoint | undefined>;
+  getToolExecution(runId: RunId, toolCallId: string): Promise<ToolExecutionRecord | undefined>;
+  /** On success, assigns run/session revisions and lease generation 1. */
+  createExecution(create: ExecutionCreate): Promise<boolean>;
+  commitExecution(commit: ExecutionCommit): Promise<boolean>;
+  /** Acquires only absent/expired leases and assigns a strictly newer generation. */
+  acquireLease(lease: RunLease): Promise<boolean>;
+  /** Requires matching owner/generation and an unexpired stored lease. */
+  renewLease(lease: RunLease): Promise<boolean>;
+  /** Expires a matching token while retaining its generation for future acquisitions. */
+  releaseLease(runId: RunId, ownerId: string, generation: number): Promise<void>;
+}
+declare function isDurableRunStore(store: RunStore): store is DurableRunStore;
+interface RunRequest<TInput = unknown, TOutput = unknown> {
+  input: TInput;
+  model?: string;
+  reasoning?: ReasoningEffort;
+  context?: ExecutionContext;
+  limits?: AgentLimits;
+  contextBudget?: ContextBudget;
+  toolSearch?: ToolSearchOptions;
+  elicitation?: ElicitationMode;
+  approvalMode?: ApprovalMode;
+  toolChoice?: ToolChoice;
+  sessionId?: SessionId;
+  signal?: AbortSignal;
+  /** Maximum wall-clock time for this run, including time spent paused. */
+  deadlineMs?: number;
+}
+interface RunResult<TOutput = unknown> {
+  runId: RunId;
+  sessionId: SessionId;
+  output: TOutput;
+  events?: AgentEvent[];
+  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;
+  /** Redacts the summary before it enters the context.compacted event. */
+  redactSummary?: (summary: string) => string;
+}
+/** Cumulative runtime counters for automatic context compaction. */
+interface ContextCompactionStats {
+  compactions: number;
+  removedMessages: number;
+  estimatedTokens: number;
+  compactedTokens: number;
+  savedTokens: number;
+}
+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 ModelContextCompactorOptions {
+  /** Model used only to summarize older context. */
+  model: ModelGateway;
+  /** Overrides the built-in summarization instructions. */
+  systemPrompt?: string;
+  /** Maximum output tokens for the summary. Defaults to 1,024. */
+  maxOutputTokens?: number;
+  /** Maximum characters sent to one summarization call. Defaults to 120,000. */
+  maxInputChars?: number;
+}
+/**
+ * Creates a semantic compactor backed by a model. Use a cheap, fast model and
+ * keep it separate from the agent model when possible. Large transcripts are
+ * summarized in chunks and then merged.
+ */
+declare function createModelContextCompactor(options: ModelContextCompactorOptions): ContextCompactor;
+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.
+ *
+ * Values are cloned at the boundary so callers cannot mutate persisted state.
+ * Data is lost when the process exits.
+ */
+declare class InMemoryRunStore implements DurableRunStore {
+  #private;
+  getRun<TRun extends RunRecord<unknown> = AgentRun>(runId: RunId): Promise<TRun | undefined>;
+  saveRun(run: RunRecord): Promise<void>;
+  getSession(sessionId: SessionId): Promise<Session | undefined>;
+  saveSession(session: Session): Promise<void>;
+  appendEvent(event: AgentEvent): Promise<void>;
+  listEvents(runId: RunId, options?: ListEventsOptions): Promise<AgentEvent[]>;
+  getCheckpoint<TCheckpoint extends StoredRunCheckpoint = RunCheckpoint>(runId: RunId): Promise<TCheckpoint | undefined>;
+  getToolExecution(runId: RunId, toolCallId: string): Promise<ToolExecutionRecord | undefined>;
+  createExecution(create: ExecutionCreate): Promise<boolean>;
+  commitExecution(commit: ExecutionCommit): Promise<boolean>;
+  purgeRuns(options?: PurgeRunsOptions): Promise<PurgeRunsResult>;
+  acquireLease(lease: RunLease): Promise<boolean>;
+  renewLease(lease: RunLease): Promise<boolean>;
+  releaseLease(runId: RunId, ownerId: string, generation: number): Promise<void>;
+}
+//#endregion
+//#region src/agents/agent.d.ts
+/** Resource limits enforced by the runtime for a single agent run. */
+interface AgentLimits {
+  maxSteps?: number;
+  maxToolCalls?: number;
+  maxInputTokens?: number | false;
+  maxOutputTokens?: number | false;
+  /** Maximum serialized bytes for one tool result. Use `false` to disable the default cap. */
+  maxToolResultBytes?: 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 ToolSearchSemanticOptions {
+  /** Embedding model used to index tools and queries. */
+  embeddings: EmbeddingModel;
+  /** Cache for tool vectors. Defaults to the runtime cache. */
+  cache?: ToolEmbeddingCache;
+  /** Vector candidates considered before fusion. Defaults to 20. */
+  topK?: number;
+  /** Minimum cosine score for vector candidates. Defaults to 0. */
+  minScore?: number;
+  /** Optional second-stage reranker over the fused candidates. */
+  reranker?: ToolReranker;
+}
+/** On-demand tool discovery for agents with large tool catalogs. */
+interface ToolSearchOptions {
+  /** `auto` enables search above the configured thresholds. Defaults to `auto`. */
+  mode?: 'auto' | 'on' | 'off';
+  /** Tool-count threshold for `auto`. Defaults to 30. */
+  threshold?: number;
+  /** Estimated tool-token threshold for `auto`. */
+  tokenThreshold?: number;
+  /** Maximum tools returned by one search. Defaults to 5. */
+  limit?: number;
+  /** Tool names exposed without a search. */
+  pinned?: string[];
+  /** Optional hybrid lexical + vector retrieval. */
+  semantic?: ToolSearchSemanticOptions;
+}
+/** Serializable tool-search options stored in a run checkpoint. */
+type ToolSearchCheckpointOptions = Omit<ToolSearchOptions, 'semantic'>;
+interface AgentDefinition<TInput = unknown, TOutput = unknown> {
+  name: string;
+  instructions: string;
+  model?: ModelRef;
+  tools?: string[];
+  context?: string[];
+  memory?: {
+    read?: boolean;
+    write?: boolean;
+    limit?: number;
+  };
+  skills?: string[];
+  reasoning?: ReasoningEffort;
+  modelOptions?: Record<string, unknown>;
+  toolChoice?: ToolChoice;
+  elicitation?: ElicitationMode;
+  approvalMode?: ApprovalMode;
+  inputSchema?: StandardSchemaV1<unknown, TInput>;
+  outputSchema?: StandardSchemaV1<unknown, TOutput>;
+  limits?: AgentLimits;
+  contextBudget?: ContextBudget;
+  toolSearch?: ToolSearchOptions;
+}
+declare function defineAgent<T extends AgentDefinition>(agent: ExactDefinition<T, AgentDefinition>): T;
+//#endregion
+export { SessionCompaction as $, ElicitationMode as A, ResumeRunResolution as B, ApprovalMode as C, CoordinatorRun as D, CoordinatorCheckpoint as E, ExecutionCreate as F, RunLease as G, RetainableRunStore as H, ListEventsOptions as I, RunRequest as J, RunPause as K, PendingToolExecution as L, ElicitationResolution as M, EventResolution as N, CredentialStore as O, ExecutionCommit as P, Session as Q, PurgeRunsOptions as R, AgentRunPause as S, ApprovalResolution as T, RunCheckpoint as U, RetainableRunStatus as V, RunCorrelation as W, RunStatus as X, RunResult as Y, RunStore as Z, createDigestContextCompactor as _, validatePurgeRunsOptions as _t, ToolSearchOptions as a, ToolExecutionRecord as at, resolveContextBudget as b, InMemoryRunStore as c, WorkflowBudgetUsage as ct, ContextCompactionStats as d, WorkflowRun as dt, SessionId as et, ContextCompactor as f, WorkflowStepRecord as ft, ResolvedContextBudget as g, validateListEventsOptions as gt, ModelContextCompactorOptions as h, isRetainableRunStore as ht, ToolSearchCheckpointOptions as i, TimerResolution as it, ElicitationRequest as j, DurableRunStore as k, ContextCompactionInput as l, WorkflowCheckpoint as lt, DigestContextCompactorOptions as m, isDurableRunStore as mt, AgentLimits as n, TeamCheckpoint as nt, ToolSearchSemanticOptions as o, ToolExecutionResolution as ot, ContextTokenEstimator as p, WorkflowWaitRecord as pt, RunRecord as q, ContextBudget as r, TeamRun as rt, defineAgent as s, ToolExecutionStatus as st, AgentDefinition as t, StoredRunCheckpoint as tt, ContextCompactionOptions as u, WorkflowCompensationRecord as ut, createModelContextCompactor as v, ApprovalRequest as w, AgentRun as x, estimateContextTokens as y, PurgeRunsResult as z };

package/dist/index.d.mts

@@ -1,19 +1,31 @@
-import { a as AgentMessageRole, c as JsonPrimitive, d as PROVIDER_SCHEMA_UNSUPPORTED, f as RunId, h as ToolSpec, 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 "./index-C_Zpr13f.mjs";
-import { ModelGateway, ModelInput, ModelMetadata, ModelRef, ModelResult, ModelStreamEvent, ModelUsage, ReasoningEffort } from "./models/index.mjs";
-import { n as AgentLimits, r as defineAgent, t as AgentDefinition } from "./index-BzxHfyYV.mjs";
-import { C as isDurableRunStore, S as ToolExecutionStatus, _ as RunStore, a as DurableRunStore, b as ToolExecutionRecord, c as ListEventsOptions, d as RunCheckpoint, f as RunLease, g as RunStatus, h as RunResult, i as CredentialStore, l as PendingToolExecution, m as RunRequest, n as ApprovalRequest, o as ExecutionCommit, p as RunPause, r as ApprovalResolution, s as InMemoryRunStore, t as AgentRun, u as ResumeRunResolution, v as Session, x as ToolExecutionResolution, y as SessionId } from "./index-DGWOGXzc.mjs";
-import { a as ToolResult, c as defineTool, i as ToolIdempotency, l as toToolSpec, n as ToolDefinition, o as ToolRetryPolicy, r as ToolExecutionContext, s as ToolRisk, t as ToolApproval } from "./index-CZGyhNIQ.mjs";
-import { i as definePolicy, n as PolicyDecision, r as PolicyDefinition, t as PolicyAuthorization } from "./index-QTkd6a7C.mjs";
-import { n as FevexConfig, r as createFevex, t as Fevex } from "./fevex-Dz6GBz9o.mjs";
+import { A as ToolApproval, C as ConnectionToolPolicy, D as ToolProviderContext, E as ToolProvider, F as ToolRetryPolicy, I as ToolRisk, L as defineTool, M as ToolExecutionContext, N as ToolIdempotency, O as ToolProviderTool, P as ToolResult, R as toToolSpec, S as ConnectionDefinition, T as IntegrationErrorCategory, _ as FevexJsonSchemaProfileLimits, a as InMemoryToolEmbeddingCacheOptions, b as compileFevexJsonSchema, c as ToolEmbeddingIndexEntry, d as cosineSimilarity, f as schemaKeywords, g as FEVEX_JSON_SCHEMA_PROFILE_VERSION, h as toolEmbeddingText, i as InMemoryToolEmbeddingCache, j as ToolDefinition, k as defineConnection, l as ToolEmbeddingMatch, m as toolEmbeddingKey, n as ToolSearchCandidate, o as ToolEmbeddingCache, p as searchToolEmbeddingIndex, r as BuildToolEmbeddingIndexOptions, s as ToolEmbeddingIndex, t as ToolReranker, u as buildToolEmbeddingIndex, v as FevexJsonSchemaProfileOptions, w as IntegrationError, x as validateFevexJsonSchemaProfile, y as FevexJsonSchemaValidator } from "./index-DHcfIfh-.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, u as EmbeddingModel } from "./index-D7r0puBi.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 SandboxError, c as sandboxResultToJson, i as SandboxCapabilities, n as createLocalSandbox, o as SandboxRunRequest, r as Sandbox, s as SandboxRunResult, t as LocalSandboxOptions } from "./index-DUhNa7IR.mjs";
+import { $ as SessionCompaction, A as ElicitationMode, B as ResumeRunResolution, C as ApprovalMode, D as CoordinatorRun, E as CoordinatorCheckpoint, F as ExecutionCreate, G as RunLease, H as RetainableRunStore, I as ListEventsOptions, J as RunRequest, K as RunPause, L as PendingToolExecution, M as ElicitationResolution, N as EventResolution, O as CredentialStore, P as ExecutionCommit, Q as Session, R as PurgeRunsOptions, S as AgentRunPause, T as ApprovalResolution, U as RunCheckpoint, V as RetainableRunStatus, W as RunCorrelation, X as RunStatus, Y as RunResult, Z as RunStore, _ as createDigestContextCompactor, _t as validatePurgeRunsOptions, a as ToolSearchOptions, at as ToolExecutionRecord, b as resolveContextBudget, c as InMemoryRunStore, ct as WorkflowBudgetUsage, d as ContextCompactionStats, dt as WorkflowRun, et as SessionId, f as ContextCompactor, ft as WorkflowStepRecord, g as ResolvedContextBudget, gt as validateListEventsOptions, h as ModelContextCompactorOptions, ht as isRetainableRunStore, i as ToolSearchCheckpointOptions, it as TimerResolution, j as ElicitationRequest, k as DurableRunStore, l as ContextCompactionInput, lt as WorkflowCheckpoint, m as DigestContextCompactorOptions, mt as isDurableRunStore, n as AgentLimits, nt as TeamCheckpoint, o as ToolSearchSemanticOptions, ot as ToolExecutionResolution, p as ContextTokenEstimator, pt as WorkflowWaitRecord, q as RunRecord, r as ContextBudget, rt as TeamRun, s as defineAgent, st as ToolExecutionStatus, t as AgentDefinition, tt as StoredRunCheckpoint, u as ContextCompactionOptions, ut as WorkflowCompensationRecord, v as createModelContextCompactor, w as ApprovalRequest, x as AgentRun, y as estimateContextTokens, z as PurgeRunsResult } from "./index-lCCFokc6.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-CIHWc5V1.mjs";
+import { i as definePolicy, n as PolicyDecision, r as PolicyDefinition, t as PolicyAuthorization } from "./index-CFzrvDQ0.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-Btth7rdL.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-26ilbzAs.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-_KOsOsB8.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-B8EcvWeN.mjs";
 //#region src/configuration-error.d.ts
-type FevexConfigurationErrorCode = 'INVALID_CONFIG' | 'INVALID_MODEL' | 'INVALID_AGENT' | 'INVALID_TOOL' | 'DUPLICATE_AGENT' | 'DUPLICATE_TOOL' | 'MISSING_MODEL' | 'MISSING_TOOL';
+/**
+ * Composition error codes.
+ *
+ * `INVALID_CONFIG` is reserved for the shape of the root config object. Every
+ * registered entity has its own `INVALID_*` code, plus `DUPLICATE_*` when it is
+ * registered by name and `MISSING_*` when an agent references something that
+ * was never registered.
+ */
+type FevexConfigurationErrorCode = 'INVALID_CONFIG' | 'INVALID_MODEL' | 'INVALID_AGENT' | 'INVALID_TOOL' | 'INVALID_WORKFLOW' | 'INVALID_TEAM' | 'INVALID_CONNECTION' | 'INVALID_CONTEXT_PROVIDER' | 'INVALID_POLICY' | 'DUPLICATE_AGENT' | 'DUPLICATE_TOOL' | 'DUPLICATE_WORKFLOW' | 'DUPLICATE_TEAM' | 'DUPLICATE_CONTEXT_PROVIDER' | 'MISSING_MODEL' | 'MISSING_TOOL';
 declare class FevexConfigurationError extends Error {
   readonly code: FevexConfigurationErrorCode;
   constructor(code: FevexConfigurationErrorCode, message: string);
 }
 //#endregion
 //#region src/run-error.d.ts
-type FevexRunErrorCode = 'DURABLE_STORE_REQUIRED' | 'RUN_CONFLICT' | 'RUN_NOT_RESUMABLE' | 'RUN_DEFINITION_CHANGED' | 'POLICY_DENIED' | 'CREDENTIAL_NOT_FOUND' | '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' | 'TOOL_RESULT_TOO_LARGE' | '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;
@@ -27,4 +39,4 @@ declare class RunPausedError extends FevexRunError {
   constructor(runId: RunId, pause: RunPause);
 }
 //#endregion
-export { AgentDefinition, AgentEvent, AgentEventPayloads, AgentEventType, AgentLimits, AgentMessage, AgentMessageRole, AgentRun, ApprovalRequest, ApprovalResolution, CredentialStore, DurableRunStore, ExecutionCommit, ExecutionContext, Fevex, FevexConfig, FevexConfigurationError, FevexConfigurationErrorCode, FevexRunError, FevexRunErrorCode, InMemoryRunStore, JsonObject, JsonPrimitive, JsonValue, ListEventsOptions, ModelGateway, ModelInput, ModelMetadata, ModelRef, ModelResult, ModelStreamEvent, ModelUsage, PROVIDER_REASONING_UNSUPPORTED, PROVIDER_SCHEMA_UNSUPPORTED, PendingToolExecution, PolicyAuthorization, PolicyDecision, PolicyDefinition, ReasoningEffort, ResumeRunResolution, RunCheckpoint, RunId, RunLease, RunPause, RunPausedError, RunRequest, RunResult, RunStatus, RunStore, SCHEMA_NOT_TRANSPORTABLE, Session, SessionId, ToolApproval, ToolCall, ToolDefinition, ToolExecutionContext, ToolExecutionRecord, ToolExecutionResolution, ToolExecutionStatus, ToolIdempotency, ToolResult, ToolRetryPolicy, ToolRisk, ToolSpec, createFevex, defineAgent, definePolicy, defineTool, isDurableRunStore, toToolSpec };
+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, BuildToolEmbeddingIndexOptions, CatalogedArtifactStore, CatalogedArtifactStoreOptions, ChannelAdapter, ChannelContext, ChannelDeliveryOptions, ChannelElicitationContext, ChannelError, ChannelEvent, ChannelEventType, ChannelFailurePhase, ChannelMessage, ChannelOutput, ChannelRunEvent, ChannelRunOptions, ChannelRunResult, ConnectionDefinition, ConnectionToolPolicy, ContextBlock, ContextBudget, ContextCompactionInput, ContextCompactionOptions, ContextCompactionStats, ContextCompactor, ContextProvider, ContextTokenEstimator, CoordinatorCheckpoint, CoordinatorRun, CredentialStore, DigestContextCompactorOptions, DurableRunStore, ElicitationMode, ElicitationRequest, ElicitationResolution, EmbeddingModel, 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, InMemoryToolEmbeddingCache, InMemoryToolEmbeddingCacheOptions, IntegrationError, IntegrationErrorCategory, JsonObject, JsonPrimitive, JsonValue, KnowledgeContext, ListEventsOptions, LoadSkillFileOptions, LocalSandboxOptions, MemoryQuery, MemoryRecord, MemoryStore, MemoryWrite, ModelContextCompactorOptions, 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, ToolEmbeddingCache, ToolEmbeddingIndex, ToolEmbeddingIndexEntry, ToolEmbeddingMatch, ToolEventSource, ToolExecutionContext, ToolExecutionRecord, ToolExecutionResolution, ToolExecutionStatus, ToolIdempotency, ToolProvider, ToolProviderContext, ToolProviderTool, ToolReranker, ToolResult, ToolRetryPolicy, ToolRisk, ToolSearchCandidate, ToolSearchCheckpointOptions, ToolSearchOptions, ToolSearchSemanticOptions, ToolSpec, WorkflowAgentResult, WorkflowBudgetUsage, WorkflowCheckpoint, WorkflowCompensationRecord, WorkflowDefinition, WorkflowEventDefinition, WorkflowEventResult, WorkflowRun, WorkflowStep, WorkflowStepContext, WorkflowStepOptions, WorkflowStepRecord, WorkflowWaitRecord, artifactTenantId, assertArtifactId, buildToolEmbeddingIndex, compileFevexJsonSchema, cosineSimilarity, createAgentsMdContextProvider, createDigestContextCompactor, createFevex, createLocalSandbox, createMemoryContextProvider, createModelContextCompactor, defineAgent, defineConnection, defineContextProvider, definePolicy, defineSkill, defineTeam, defineTool, defineWorkflow, deliverChannelRun, estimateContextTokens, handleChannelInput, isDurableRunStore, isProgressiveSkillProvider, isRetainableRunStore, loadSkillFile, loadSkillFiles, resolveContextBudget, sandboxResultToJson, schemaKeywords, searchToolEmbeddingIndex, toToolSpec, toolEmbeddingKey, toolEmbeddingText, validateFevexJsonSchemaProfile, validateListEventsOptions, validatePurgeRunsOptions };