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

package/README.md

@@ -28,18 +28,26 @@ adapters, validation and tests without adopting a heavy runtime.
 npm install @fevex/core
 ```
 
-For official model adapters:
+The npm release pipeline publishes exactly three official packages:
 
 ```bash
 npm install @fevex/core @fevex/openai
 npm install @fevex/core @fevex/deepseek
-npm install @fevex/core @fevex/mcp
-npm install @fevex/core @fevex/openapi
-npm install @fevex/core @fevex/sqlite
-npm install @fevex/core @fevex/postgres
-npm install @fevex/core @fevex/opentelemetry @opentelemetry/api
 ```
 
+CI builds, typechecks, tests and tarball-smokes all nine packages. The
+repository-only integrations below are **not published to npm** by the release
+pipeline; use them from this repository until they are published:
+
+| Package | Purpose |
+| --- | --- |
+| `@fevex/mcp` | Model Context Protocol tools and connections |
+| `@fevex/openapi` | Tools generated from an OpenAPI document |
+| `@fevex/sqlite` | SQLite run and session store |
+| `@fevex/postgres` | PostgreSQL run and session store |
+| `@fevex/opentelemetry` | OpenTelemetry trace and metric export |
+| `@fevex/browser` | Browser automation tools |
+
 Schemas are optional. The examples use Zod 4, but any Standard
 Schema-compatible validator can be used:
 
@@ -47,6 +55,20 @@ Schema-compatible validator can be used:
 npm install zod
 ```
 
+## Compatibility & releases
+
+FEVEX is pre-1.0. Documented imports from official packages are the public API;
+`src/internal`, undocumented paths and checkpoint shapes are not. While in alpha,
+`minor` releases may contain breaking changes with migration notes; `patch`
+releases stay compatible. Store migrations are forward-only, checkpoints are
+versioned and private, and downgrades are not supported.
+
+Only the latest alpha is supported; pin exact versions in production. Releases
+come from reviewed changesets, publish only the three official packages, and
+place alpha versions on the npm `latest` tag. Read the full
+[compatibility and release policy](https://fevex.dev/docs/compatibility/) before
+upgrading a durable deployment.
+
 ## Quickstart
 
 This example executes a complete model-tool-model cycle without network access:
@@ -730,8 +752,50 @@ Traces contain only metadata by default. Output and safe error capture require
 an explicit `content.include` policy; sensitive object keys are redacted before
 an optional application redactor runs. Exporters run outside the run path: their
 errors never change the run result, and `flushObservability()` reports pending
-export failures. OpenTelemetry SDK setup, OTLP export and shutdown remain
-application responsibilities.
+export failures. Export work is bounded and deduplicated:
+
+```ts
+const app = createFevex({
+  models,
+  agents,
+  observability: {
+    exporters: [createOpenTelemetryExporter()],
+    exportQueue: {
+      concurrency: 4,
+      maxQueued: 100,
+      timeoutMs: 30_000,
+      maxFailures: 100,
+    },
+  },
+});
+
+await app.flushObservability({ timeoutMs: 5_000 });
+console.log(app.getObservabilityStats());
+```
+
+Workflow and team traces carry `kind` and a span per step. Agent steps expose
+`childRunId`; child agent traces carry `parentRunId` and `rootRunId`, and tool
+spans are nested under the model call that requested them. A dropped trace or a
+failed export is counted in `getObservabilityStats()`, and the next
+`flushObservability()` rejects with the failures accumulated since the previous
+flush. OpenTelemetry SDK setup, OTLP export and shutdown remain application
+responsibilities.
+
+## Graceful shutdown
+
+`shutdown` stops admission, drains active runs, cancels what remains at the
+deadline and flushes trace exports:
+
+```ts
+const result = await app.shutdown({ timeoutMs: 30_000 });
+console.log(result.timedOut, result.cancelledRunIds, result.observability);
+```
+
+New starts, resumes and recoveries fail with `RUNTIME_CLOSED` (HTTP `503`) once
+shutdown begins. The host closes its HTTP server, stores and external adapters
+after `shutdown` returns. See
+[Operations & soak tests](https://fevex.dev/docs/operations/) for crash recovery
+and the 1–8 hour load harness.
 
 ## Evaluations
 
@@ -914,6 +978,33 @@ const app = createFevex({
 });
 ```
 
+For longer instructions, keep them in an explicit `SKILL.md` file. Only the
+frontmatter metadata enters the prompt; the body loads on demand:
+
+```ts
+import { createAgentsMdContextProvider, loadSkillFile } from '@fevex/core';
+
+const refunds = await loadSkillFile('./skills/refunds/SKILL.md');
+
+const app = createFevex({
+  models,
+  contextProviders: [refunds, createAgentsMdContextProvider('./AGENTS.md')],
+  agents: [
+    defineAgent({
+      name: 'support',
+      instructions: 'Answer with business context.',
+      skills: ['refunds'],
+      context: ['agents-md'],
+    }),
+  ],
+});
+```
+
+`SKILL.md` uses `name` and `description` frontmatter. The reserved
+`fevex__load_skill` tool loads the body and lists files under `references/`,
+`scripts/` and `assets/`; scripts are not executed by the runtime. Paths are
+explicit, with no automatic discovery.
+
 Context providers are lazy per run. Memory is a replaceable store; the built-in
 store is in-memory substring search, not embeddings, vector search or durable
 storage.
@@ -1049,7 +1140,7 @@ the artifact available.
 | `@fevex/core/runtime` | Runs, sessions and store contracts |
 | `@fevex/core/sandbox` | Sandbox contract and local development sandbox |
 | `@fevex/core/policies` | Authorization policy contracts |
-| `@fevex/core/observability` | Trace, redaction and cost contracts |
+| `@fevex/core/observability` | Trace, bounded export queue, redaction and cost contracts |
 | `@fevex/core/evals` | Datasets, scorers, reporters and regressions |
 | `@fevex/core/testing` | Deterministic testing helpers |
 

package/dist/agents/index.d.mts

@@ -1,2 +1,2 @@
-import { n as AgentLimits, r as defineAgent, t as AgentDefinition } from "../index-CGmHXV31.mjs";
+import { n as AgentLimits, r as defineAgent, t as AgentDefinition } from "../index-CzAi2Y_Z.mjs";
 export { AgentDefinition, AgentLimits, 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-BDVUoAU6.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-B8laW1hM.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--_LdSEuF.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";
 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-BDVUoAU6.mjs";
-import { r as ModelMetadata, s as ModelUsage } from "../index-BPwkgdo3.mjs";
-import { l as TraceCost, t as CostCalculator } from "../index-D6lnI92z.mjs";
-import { t as Fevex } from "../fevex-B5NxFKcV.mjs";
+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";
 //#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-B5NxFKcV.d.mts → fevex-CVMLnZsk.d.mts}

@@ -1,13 +1,13 @@
-import { F as ArtifactStore, f as RunId, o as ExecutionContext, t as AgentEvent } from "./types-BDVUoAU6.mjs";
-import { t as ModelGateway } from "./index-BPwkgdo3.mjs";
-import { A as RunRecord, C as PurgeRunsResult, F as Session, I as SessionId, M as RunResult, P as RunStore, S as PurgeRunsOptions, a as AgentRun, b as ListEventsOptions, f as CredentialStore, j as RunRequest, q as WorkflowRun, t as AgentDefinition, w as ResumeRunResolution, z as TeamRun } from "./index-CGmHXV31.mjs";
-import { r as ContextProvider, s as MemoryStore } from "./index-aayvtf0J.mjs";
-import { r as ObservabilityOptions } from "./index-D6lnI92z.mjs";
-import { r as Sandbox } from "./index-BFnWUu7j.mjs";
-import { g as ToolDefinition, s as ConnectionDefinition } from "./index-CKQCNvJz.mjs";
-import { r as PolicyDefinition } from "./index-Cb3AB98n.mjs";
-import { n as WorkflowDefinition } from "./index-Br-zPxZH.mjs";
-import { t as TeamDefinition } from "./index-Dsulk-n6.mjs";
+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";
 //#region src/fevex.d.ts
 interface FevexAdmissionRequest {
   kind: 'agent' | 'workflow' | 'team';
@@ -27,6 +27,25 @@ interface FevexAdmission {
   /** Custom admission check, called after the built-in limits. */
   authorize?: (request: FevexAdmissionRequest) => boolean | Promise<boolean>;
 }
+interface FevexShutdownOptions {
+  /**
+   * Maximum time to wait for active runs before cancelling them. Defaults to
+   * 30 seconds. Use `0` to cancel immediately. If the deadline expires,
+   * shutdown allows up to 5 additional seconds for forced cancellation and the
+   * final trace flush.
+   */
+  timeoutMs?: number;
+}
+interface FevexShutdownResult {
+  /** Runs that were still active when the grace period expired. */
+  cancelledRunIds: RunId[];
+  /** True when the grace deadline expired before all active runs finished. */
+  timedOut: boolean;
+  /** Error surfaced while flushing pending traces, if any. */
+  exportError?: unknown;
+  /** Observability counters after the shutdown flush. */
+  observability: ObservabilityStats;
+}
 interface FevexLimits {
   /**
    * Maximum non-control events persisted for one run. Control events such as
@@ -77,7 +96,17 @@ interface Fevex {
   }): Promise<RunRecord<TOutput>>;
   purgeRuns(options?: PurgeRunsOptions): Promise<PurgeRunsResult>;
   compactSession(sessionId: SessionId, summary: string): Promise<Session>;
-  flushObservability(): Promise<void>;
+  /** Waits for queued exports and rejects with failures accumulated since the previous flush. */
+  flushObservability(options?: {
+    timeoutMs?: number;
+  }): Promise<void>;
+  /** Cumulative trace export counters for this runtime. */
+  getObservabilityStats(): ObservabilityStats;
+  /**
+   * Stops admitting new work, drains or cancels active runs, and flushes trace
+   * exports. The host still owns closing its stores and external adapters.
+   */
+  shutdown(options?: FevexShutdownOptions): Promise<FevexShutdownResult>;
 }
 /**
  * Validates a configuration snapshot and creates an isolated runtime.
@@ -87,4 +116,4 @@ interface Fevex {
  */
 declare function createFevex(config: FevexConfig): Fevex;
 //#endregion
-export { FevexLimits as a, FevexConfig as i, FevexAdmission as n, createFevex as o, FevexAdmissionRequest as r, Fevex as t };
+export { FevexLimits as a, createFevex as c, FevexConfig as i, FevexAdmission as n, FevexShutdownOptions as o, FevexAdmissionRequest as r, FevexShutdownResult as s, Fevex as t };

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-BDVUoAU6.mjs";
-import { c as ReasoningEffort } from "../index-BPwkgdo3.mjs";
-import { A as RunRecord, I as SessionId, a as AgentRun, q as WorkflowRun, z as TeamRun } from "../index-CGmHXV31.mjs";
-import { t as Fevex } from "../fevex-B5NxFKcV.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-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";
 //#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/http/index.mjs

@@ -24,6 +24,7 @@ const FEVEX_RUN_ERROR_CODES = /* @__PURE__ */ new Set([
 	"RUN_DEFINITION_CHANGED",
 	"POLICY_DENIED",
 	"ADMISSION_DENIED",
+	"RUNTIME_CLOSED",
 	"CREDENTIAL_NOT_FOUND",
 	"SANDBOX_REQUIRED",
 	"ELICITATION_INVALID",
@@ -654,6 +655,7 @@ function statusForRunErrorCode(code) {
 	if (code === "APPROVAL_INVALID" || code === "INVALID_CURSOR") return 400;
 	if (code === "POLICY_DENIED") return 403;
 	if (code === "ADMISSION_DENIED") return 429;
+	if (code === "RUNTIME_CLOSED") return 503;
 	return 409;
 }
 function statusForArtifactErrorCode(code) {

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

@@ -1,7 +1,7 @@
 import { t as ExactDefinition } from "./exact-definition-NHBBFlFR.mjs";
-import { o as ExecutionContext } from "./types-BDVUoAU6.mjs";
-import { n as AgentLimits } from "./index-CGmHXV31.mjs";
-import { t as WorkflowAgentResult } from "./index-Br-zPxZH.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 { StandardSchemaV1 } from "@standard-schema/spec";
 //#region src/teams/team.d.ts
 interface TeamMember {

package/dist/{index-CKQCNvJz.d.mts → index-5p3q2yIp.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-BDVUoAU6.mjs";
-import { i as SandboxCapabilities, r as Sandbox } from "./index-BFnWUu7j.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 { StandardSchemaV1 } from "@standard-schema/spec";
 //#region src/tools/tool.d.ts
 interface ToolExecutionContext {

package/dist/index-B0AdFbgr.d.mts

@@ -0,0 +1,116 @@
+import { l as JsonValue, o as ExecutionContext, s as JsonObject } from "./types-B8laW1hM.mjs";
+import { L as SessionId } from "./index-CzAi2Y_Z.mjs";
+//#region src/knowledge/knowledge.d.ts
+/** Runtime context supplied to knowledge providers and memory stores. */
+interface KnowledgeContext {
+  agentName: string;
+  input: string;
+  sessionId: SessionId;
+  context?: ExecutionContext;
+  signal?: AbortSignal;
+}
+interface ContextBlock {
+  id: string;
+  content: string;
+  metadata?: JsonObject;
+}
+interface ContextProvider {
+  name: string;
+  read(context: KnowledgeContext): Promise<ContextBlock[]>;
+}
+interface MemoryQuery {
+  query: string;
+  limit?: number;
+  agentName?: string;
+  sessionId?: SessionId;
+  namespace?: string;
+  actor?: ExecutionContext['actor'];
+}
+interface MemoryWrite {
+  content: string;
+  agentName?: string;
+  sessionId?: SessionId;
+  namespace?: string;
+  actor?: ExecutionContext['actor'];
+  metadata?: JsonObject;
+}
+interface MemoryRecord extends MemoryWrite {
+  id: string;
+  createdAt: string;
+}
+interface MemoryStore {
+  search(query: MemoryQuery, context: KnowledgeContext): Promise<MemoryRecord[]>;
+  write(record: MemoryWrite, context: KnowledgeContext): Promise<MemoryRecord>;
+}
+interface SkillDefinition {
+  name: string;
+  instructions: string;
+  resources?: Array<string | JsonValue | {
+    id?: string;
+    content: string | JsonValue;
+    metadata?: JsonObject;
+  }>;
+}
+/**
+ * Context provider that advertises a skill's metadata and defers its full
+ * instructions until the model calls the reserved load-skill tool.
+ *
+ * The provider name is the skill name referenced from `agent.skills`.
+ */
+interface ProgressiveSkillProvider extends ContextProvider {
+  /** Short description shown to the model before the skill is loaded. */
+  readonly description: string;
+  /** Loads the full instructions, or one resource when `resource` is set. */
+  load(context: KnowledgeContext, resource?: string): Promise<ContextBlock[]>;
+}
+declare function isProgressiveSkillProvider(provider: ContextProvider): provider is ProgressiveSkillProvider;
+declare function defineContextProvider<T extends ContextProvider>(provider: T): T;
+declare function defineSkill(skill: SkillDefinition): ContextProvider;
+declare function createMemoryContextProvider(options: {
+  name?: string;
+  store: MemoryStore;
+  limit?: number;
+}): ContextProvider;
+//#endregion
+//#region src/knowledge/agents-md.d.ts
+interface AgentsMdOptions {
+  /** Explicit path to an `AGENTS.md` file. */
+  path: string;
+  /** Context provider name; defaults to `agents-md`. */
+  name?: string;
+  maxBytes?: number;
+}
+/**
+ * Reads one explicit `AGENTS.md` file as context.
+ *
+ * Fevex never walks the filesystem looking for `AGENTS.md`; register one
+ * provider per file and reference its name from `agent.context`.
+ */
+declare function createAgentsMdContextProvider(options: AgentsMdOptions | string): ContextProvider;
+//#endregion
+//#region src/knowledge/in-memory-memory-store.d.ts
+/** Volatile keyword-search memory store for tests and local development. */
+declare class InMemoryMemoryStore implements MemoryStore {
+  #private;
+  search(query: MemoryQuery, context: KnowledgeContext): Promise<MemoryRecord[]>;
+  write(record: MemoryWrite, context: KnowledgeContext): Promise<MemoryRecord>;
+}
+//#endregion
+//#region src/knowledge/skill-file.d.ts
+interface LoadSkillFileOptions {
+  /** Maximum size of the `SKILL.md` file. */
+  maxBytes?: number;
+  /** Maximum size of one resource loaded on demand. */
+  maxResourceBytes?: number;
+}
+/**
+ * Loads one explicit `SKILL.md` file.
+ *
+ * Only `name` and `description` are advertised up front. The body and any
+ * files under `references/`, `scripts/` or `assets/` load on demand.
+ */
+declare function loadSkillFile(path: string, options?: LoadSkillFileOptions): Promise<ProgressiveSkillProvider>;
+/** Loads several explicit `SKILL.md` files; it never scans directories. */
+declare function loadSkillFiles(paths: readonly string[], options?: LoadSkillFileOptions): Promise<ProgressiveSkillProvider[]>;
+//#endregion
+export { defineContextProvider as _, AgentsMdOptions as a, ContextProvider as c, MemoryRecord as d, MemoryStore as f, createMemoryContextProvider as g, SkillDefinition as h, InMemoryMemoryStore as i, KnowledgeContext as l, ProgressiveSkillProvider as m, loadSkillFile as n, createAgentsMdContextProvider as o, MemoryWrite as p, loadSkillFiles as r, ContextBlock as s, LoadSkillFileOptions as t, MemoryQuery as u, defineSkill as v, isProgressiveSkillProvider as y };

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

@@ -1,6 +1,6 @@
-import { f as RunId, o as ExecutionContext, s as JsonObject, t as AgentEvent } from "./types-BDVUoAU6.mjs";
-import { I as SessionId, a as AgentRun, h as ElicitationRequest } from "./index-CGmHXV31.mjs";
-import { t as Fevex } from "./fevex-B5NxFKcV.mjs";
+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";
 //#region src/channels/channel.d.ts
 interface ChannelMessage {
   id: string;

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

@@ -1,4 +1,4 @@
-import { g as ToolSpec, i as AgentMessage, l as JsonValue, m as ToolCall, s as JsonObject } from "./types-BDVUoAU6.mjs";
+import { g as ToolSpec, i as AgentMessage, l as JsonValue, m as ToolCall, s as JsonObject } from "./types-B8laW1hM.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-Cb3AB98n.d.mts → index-CbACw6xZ.d.mts}

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

package/dist/index-CpLDt6Rw.d.mts

@@ -0,0 +1,118 @@
+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";
+//#region src/observability/trace.d.ts
+/** Final state represented by an exported run trace. */
+type TraceStatus = 'completed' | 'failed' | 'cancelled';
+/** Kind of run that produced a trace. Absent means `agent` for older traces. */
+type TraceRunKind = 'agent' | 'workflow' | 'team';
+/** Model and tool calls are agent spans; steps belong to workflow and team traces. */
+type TraceSpanKind = 'model' | 'tool' | 'step';
+type TraceContentKind = 'run.output' | 'model.output' | 'error.message';
+interface TraceCost {
+  amount: number;
+  currency: string;
+}
+interface TraceContent {
+  kind: TraceContentKind;
+  value: JsonValue;
+}
+interface TraceAnnotation {
+  name: string;
+  timestamp: string;
+  attributes?: JsonObject;
+}
+interface TraceSpan {
+  id: string;
+  /** Run or span that contains this span. */
+  parentId: string;
+  kind: TraceSpanKind;
+  name: string;
+  startedAt: string;
+  endedAt: string;
+  durationMs: number;
+  status: TraceStatus;
+  attributes: JsonObject;
+  annotations: TraceAnnotation[];
+  usage?: ModelUsage;
+  cost?: TraceCost;
+  content?: TraceContent[];
+}
+interface RunTrace {
+  schemaVersion: '1';
+  /** Absent on traces produced before coordinator traces existed; treat as `agent`. */
+  kind?: TraceRunKind;
+  traceId: string;
+  runId: RunId;
+  sessionId: SessionId;
+  /** Agent, workflow or team name. */
+  agentName: string;
+  /** Run that created this one, when it belongs to a workflow or team. */
+  parentRunId?: RunId;
+  /** Top-level run in the correlation tree. Defaults to `runId`. */
+  rootRunId?: RunId;
+  /** Only present on agent traces. */
+  modelRegistryName?: string;
+  model?: ModelMetadata;
+  startedAt: string;
+  endedAt: string;
+  durationMs: number;
+  status: TraceStatus;
+  attributes: JsonObject;
+  annotations: TraceAnnotation[];
+  spans: TraceSpan[];
+  usage?: ModelUsage;
+  cost?: TraceCost;
+  content?: TraceContent[];
+}
+interface CostCalculatorInput {
+  modelRegistryName: string;
+  model?: ModelMetadata;
+  usage: ModelUsage;
+}
+type CostCalculator = (input: CostCalculatorInput) => TraceCost | undefined;
+interface TraceRedactorInput {
+  kind: TraceContentKind;
+  value: JsonValue;
+}
+type TraceRedactor = (input: TraceRedactorInput) => JsonValue | undefined;
+interface TraceContentPolicy {
+  include: readonly TraceContentKind[];
+  redact?: TraceRedactor;
+}
+interface TraceExporter {
+  export(trace: Readonly<RunTrace>): void | Promise<void>;
+}
+interface TraceExportQueueOptions {
+  /** Traces exported at once. Defaults to 4. */
+  concurrency?: number;
+  /** Traces waiting for an export slot before new traces are dropped. Defaults to 100. */
+  maxQueued?: number;
+  /** Deadline for each exporter call. Defaults to 30 seconds. */
+  timeoutMs?: number;
+  /** Failures retained for the next `flushObservability` call. Defaults to 100. */
+  maxFailures?: number;
+}
+/** Queue and failure counters for the runtime's trace exporters. */
+interface ObservabilityStats {
+  /** Traces exported successfully since the runtime started. */
+  exported: number;
+  /** Failed exports and dropped traces since the runtime started. */
+  failed: number;
+  /** Traces dropped because the queue was full. */
+  dropped: number;
+  /** Traces waiting for an export slot. */
+  queued: number;
+  /** Traces currently being exported. */
+  active: number;
+  /** Failures retained for the next flush. */
+  retainedFailures: number;
+}
+interface ObservabilityOptions {
+  exporters: readonly TraceExporter[];
+  calculateCost?: CostCalculator;
+  content?: TraceContentPolicy;
+  exportQueue?: TraceExportQueueOptions;
+}
+//#endregion
+export { TraceSpanKind as _, RunTrace as a, TraceContentKind as c, TraceExportQueueOptions as d, TraceExporter as f, TraceSpan as g, TraceRunKind as h, ObservabilityStats as i, TraceContentPolicy as l, TraceRedactorInput as m, CostCalculatorInput as n, TraceAnnotation as o, TraceRedactor as p, ObservabilityOptions as r, TraceContent as s, CostCalculator as t, TraceCost as u, TraceStatus as v };

package/dist/{index-Br-zPxZH.d.mts → index-CseuTR-F.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-BDVUoAU6.mjs";
-import { I as SessionId, M as RunResult, j as RunRequest, n as AgentLimits } from "./index-CGmHXV31.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 { StandardSchemaV1 } from "@standard-schema/spec";
 //#region src/workflows/workflow.d.ts
 /** Context shared with workflow steps and compensation handlers. */

package/dist/{index-CGmHXV31.d.mts → index-CzAi2Y_Z.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-BDVUoAU6.mjs";
-import { c as ReasoningEffort, i as ModelRef, l as ToolChoice, r as ModelMetadata, s as ModelUsage } from "./index-BPwkgdo3.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 { StandardSchemaV1 } from "@standard-schema/spec";
 //#region src/runtime/run-store.d.ts
 /** Stable identifier for conversation history shared across runs. */
@@ -110,7 +110,14 @@ type EventResolution = {
   };
 };
 type ResumeRunResolution = ElicitationResolution | ApprovalResolution | ToolExecutionResolution | TimerResolution | EventResolution;
-interface AgentRun<TOutput = JsonValue> {
+/** 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;
@@ -129,7 +136,7 @@ interface AgentRun<TOutput = JsonValue> {
   error?: string;
   usage?: ModelUsage;
 }
-interface WorkflowRun<TOutput = JsonValue> {
+interface WorkflowRun<TOutput = JsonValue> extends RunCorrelation {
   kind: 'workflow';
   id: RunId;
   sessionId: SessionId;
@@ -145,7 +152,7 @@ interface WorkflowRun<TOutput = JsonValue> {
   error?: string;
   usage?: ModelUsage;
 }
-interface TeamRun<TOutput = JsonValue> {
+interface TeamRun<TOutput = JsonValue> extends RunCorrelation {
   kind: 'team';
   id: RunId;
   sessionId: SessionId;
@@ -457,4 +464,4 @@ interface AgentDefinition<TInput = unknown, TOutput = unknown> {
 }
 declare function defineAgent<T extends AgentDefinition>(agent: ExactDefinition<T, AgentDefinition>): T;
 //#endregion
-export { validatePurgeRunsOptions as $, RunRecord as A, TimerResolution as B, PurgeRunsResult as C, RunCheckpoint as D, RetainableRunStore as E, Session as F, WorkflowCheckpoint as G, ToolExecutionResolution as H, SessionId as I, WorkflowStepRecord as J, WorkflowCompensationRecord as K, StoredRunCheckpoint as L, RunResult as M, RunStatus as N, RunLease as O, RunStore as P, validateListEventsOptions as Q, TeamCheckpoint as R, PurgeRunsOptions as S, RetainableRunStatus as T, ToolExecutionStatus as U, ToolExecutionRecord as V, WorkflowBudgetUsage as W, isDurableRunStore as X, WorkflowWaitRecord as Y, isRetainableRunStore as Z, EventResolution as _, AgentRun as a, ListEventsOptions as b, ApprovalRequest as c, CoordinatorRun as d, CredentialStore as f, ElicitationResolution as g, ElicitationRequest as h, InMemoryRunStore as i, RunRequest as j, RunPause as k, ApprovalResolution as l, ElicitationMode as m, AgentLimits as n, AgentRunPause as o, DurableRunStore as p, WorkflowRun 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, TeamRun as z };
+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 };

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

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