eve 0.61.1 → 0.62.0

package/docs/guides/instrumentation/{providers.mdx → instrumentation.mdx}

@@ -1,42 +1,30 @@
 ---
-title: "Instrumentation Providers"
-description: "Configure experimental instrumentation providers, handle lifecycle events, and control the content each provider receives."
-url: "/observability/instrumentation-providers"
+title: "Instrumentation"
+description: "Configure lifecycle instrumentation, handle runtime events, and control the content each destination receives."
+url: "/observability/instrumentation"
 ---
 
-<Callout type="warning" title="Experimental">
-  This API is experimental and may change without a deprecation period.
-</Callout>
+Add lifecycle instrumentation as files under `agent/instrumentation/`. Each
+file handles eve runtime events independently. Configure trace exporters and
+shared span settings with the [built-in OpenTelemetry APIs](./otel).
 
-Instrumentation providers split observability into files under `agent/instrumentation/`. Each provider handles eve lifecycle events without owning the rest of the telemetry pipeline. Configure OpenTelemetry destinations with the [built-in OpenTelemetry APIs](./otel).
+The instrumentation directory replaces `agent/instrumentation.ts`. See
+[Migrate instrumentation](/docs/observability/instrumentation-migration) when
+upgrading from `eve < 0.62.0`.
 
-Enable it explicitly in `agent.ts`:
+## Add instrumentation
 
-```ts title="agent/agent.ts"
-import { defineAgent } from "eve";
-
-export default defineAgent({
-  model: "anthropic/claude-sonnet-5",
-  experimental: {
-    instrumentationProviders: true,
-  },
-});
-```
-
-The provider directory replaces `agent/instrumentation.ts`; the two layouts cannot be used together. See [Instrumentation](../observability/instrumentation) for the current single-file API.
-
-## Add a provider
-
-The filename identifies the provider slot. A lifecycle-event provider file
-must default-export `defineInstrumentation(...)` or `disableInstrumentation()`.
+The filename identifies the instrumentation slot. A lifecycle-event file must
+default-export `defineInstrumentation(...)` or `disableInstrumentation()`.
 See [OpenTelemetry](./otel) for the supported OTel declarations.
 
 ```text
 agent/instrumentation/
-  audit.ts  lifecycle event provider
+  audit.ts  lifecycle instrumentation
 ```
 
-This provider records action timing and identity without receiving tool arguments or results:
+This instrumentation records action timing and identity without receiving tool
+arguments or results:
 
 ```ts title="agent/instrumentation/audit.ts"
 import { defineInstrumentation } from "eve/instrumentation";
@@ -60,12 +48,15 @@ export default defineInstrumentation({
 });
 ```
 
-`ctx.state` is JSON storage scoped to this provider and operation. It survives durable suspension and is released after the terminal event.
+`ctx.state` is JSON storage scoped to this file and operation. It survives
+durable suspension and is released after the terminal event.
 
 ## Control inputs and outputs
 
-Each provider has an independent `tracePolicy`. It decides whether the provider
-receives a trace and whether its events include input or output content.
+Each lifecycle file created with `defineInstrumentation(...)` has an
+independent `tracePolicy`. It decides whether that file receives a trace and
+whether its events include input or output content. OpenTelemetry destinations
+share the process-wide policy declared by `otel(...)`.
 
 ```ts title="agent/instrumentation/audit.ts"
 import { defineInstrumentation } from "eve/instrumentation";
@@ -92,8 +83,8 @@ The function receives `agentName`, `channel`, `audience`, `mode`,
 `"unknown"`; `environment` is `"development"`, `"preview"`, or
 `"production"`.
 
-Without a policy, or when it returns `true`, eve sends the provider metadata
-for every trace. It includes input and output content in these cases:
+Without a policy, or when it returns `true`, eve sends metadata for every
+trace. It includes input and output content in these cases:
 
 | Environment           | Audience               | Content            |
 | --------------------- | ---------------------- | ------------------ |
@@ -101,20 +92,21 @@ for every trace. It includes input and output content in these cases:
 | Preview or production | `public`               | Inputs and outputs |
 | Preview or production | `private` or `unknown` | Metadata only      |
 
-Return `{ emit: false }` to not sample the trace for this provider. Return
+Return `{ emit: false }` to not sample the trace for this file. Return
 `{ emit: true, recordInputs, recordOutputs }` to choose the two content
 directions explicitly. Inputs include model prompts, tool arguments, channel
 input, and user responses. Outputs include model responses, tool results,
-requests for user input, provider metadata, and error details. Omitted content
-fields are unavailable to the handler.
+requests for user input, model provider metadata, and error details. Omitted
+content fields are unavailable to the handler.
 
 The channel assigns the audience once when it creates the session. It controls
 content capture, not access. See [Audience](../channels/overview#audience) for
 how the channel derives `public`, `private`, and `unknown`.
 
-## Redact fields in a custom provider
+## Redact fields
 
-Lifecycle events are immutable snapshots. Copy the fields you need into a destination-specific payload and redact that copy before sending it:
+Lifecycle events are immutable snapshots. Copy the fields you need into a
+destination-specific payload and redact that copy before sending it:
 
 ```ts title="agent/instrumentation/audit.ts"
 import { defineInstrumentation } from "eve/instrumentation";
@@ -145,7 +137,7 @@ function redactApiKey(value: unknown): unknown {
 }
 
 async function sendAuditRecord(record: unknown): Promise<void> {
-  // Send the sanitized record to your provider.
+  // Send the sanitized record to your destination.
   void record;
 }
 ```
@@ -154,15 +146,19 @@ Prefer `recordInputs: false` or `recordOutputs: false` when the destination does
 
 ## Lifecycle events
 
-Providers can handle session, channel delivery, turn, model attempt, model call, action, input request, and tool call events. Start and terminal events share an `idempotencyKey`, which can serve as a destination row ID.
+Instrumentation can handle session, channel delivery, turn, model attempt,
+model call, action, input request, and tool call events. Start and terminal
+events share an `idempotencyKey`, which can serve as a destination row ID.
 
 An ordinary tool emits both `action.*` and `tool.call.*` events. Use `action.*` for eve's durable dispatch lifecycle, including tools, skills, subagents, and remote agents. Use `tool.call.*` only when you need the AI SDK's in-process tool execution boundary.
 
-Handlers for different providers run concurrently and are failure-isolated. Do not depend on provider execution order. Use `flush` to drain buffered records and `shutdown` to release resources.
+Handlers from different files run concurrently and are failure-isolated. Do
+not depend on execution order. Use `flush` to drain buffered records and
+`shutdown` to release resources.
 
 ## What to read next
 
-- [Instrumentation](../observability/instrumentation): configure the current single-file API
-- [OpenTelemetry](./otel): configure OTel destinations and managed exports.
+- [Migrate instrumentation](/docs/observability/instrumentation-migration): replace `agent/instrumentation.ts`.
+- [OpenTelemetry](/docs/observability/otel): configure OTel destinations and managed exports.
 - [Local development](../guides/dev-tui): inspect local traces in the TUI
-- [Hooks](../guides/hooks): react to runtime events outside the instrumentation provider API
+- [Hooks](../guides/hooks): react to runtime events outside the instrumentation lifecycle

package/docs/guides/instrumentation/meta.json

@@ -1,5 +1,5 @@
 {
   "title": "Observability",
   "defaultOpen": false,
-  "pages": ["overview", "providers", "otel"]
+  "pages": ["instrumentation", "otel", "migration"]
 }

package/docs/guides/instrumentation/migration.md

@@ -0,0 +1,97 @@
+---
+title: "Migrate Instrumentation"
+description: "Move a single instrumentation.ts configuration into lifecycle instrumentation and OpenTelemetry destinations."
+url: "/observability/instrumentation-migration"
+---
+
+Replace `agent/instrumentation.ts` with path-named files under
+`agent/instrumentation/`. Remove
+`experimental.instrumentationProviders` from `agent.ts`; instrumentation
+discovery is now always enabled.
+
+## Preserve metadata-only capture
+
+In the removed API, omitted `recordInputs` and `recordOutputs` settings both
+defaulted to `false`. Once an OpenTelemetry destination is present, the new
+default includes content during development and for public conversations.
+
+Add `agent/instrumentation/otel.ts` with an explicit metadata-only policy
+before moving exporters:
+
+```ts title="agent/instrumentation/otel.ts"
+import { otel } from "eve/instrumentation/otel";
+
+export default otel({
+  functionId: "support-agent",
+  traceChannelRequests: true,
+  tracePolicy: () => ({
+    emit: true,
+    recordInputs: false,
+    recordOutputs: false,
+  }),
+});
+```
+
+After verifying each destination's retention and access controls, widen
+`recordInputs` or `recordOutputs` deliberately if needed.
+
+## Move an OpenTelemetry exporter
+
+Move each exporter into its own destination file and replace startup
+`registerOTel(...)` calls with `otelIntegration(...)`. Install `@vercel/otel`
+if the exporter comes from that package:
+
+```bash
+pnpm add @vercel/otel
+```
+
+```ts title="agent/instrumentation/honeycomb.ts"
+import { OTLPHttpProtoTraceExporter } from "@vercel/otel";
+import { otelIntegration } from "eve/instrumentation/otel";
+
+export default otelIntegration({
+  exportPolicy: {
+    span: () => ({ redact: true, inputs: true, outputs: true }),
+  },
+  traceExporter: new OTLPHttpProtoTraceExporter({
+    url: "https://api.honeycomb.io/v1/traces",
+    headers: {
+      "x-honeycomb-team": process.env.HONEYCOMB_API_KEY!,
+    },
+  }),
+});
+```
+
+The destination policy preserves metadata-only export even if the shared
+OpenTelemetry policy is widened later. Add another file for each additional
+destination; eve combines them into one pipeline.
+
+## Move runtime context and lifecycle events
+
+Use this mapping when splitting the old definition:
+
+| `agent/instrumentation.ts` field | New location                                 |
+| -------------------------------- | -------------------------------------------- |
+| `setup` with `registerOTel`      | One `otelIntegration()` file per destination |
+| `functionId`                     | `otel({ functionId })`                       |
+| `recordInputs`, `recordOutputs`  | `otel({ tracePolicy })`                      |
+| `traceChannelRequests`           | `otel({ traceChannelRequests })`             |
+| `events["step.started"]`         | `otelIntegration({ runtimeContext })`        |
+
+Move `events["step.started"]` to the destination that needs those attributes;
+see [Add runtime context](/docs/observability/otel#add-runtime-context). For
+eve lifecycle events, create a separate file with `defineInstrumentation(...)`;
+see
+[Instrumentation](/docs/observability/instrumentation).
+
+## Verify the migration
+
+Run `eve build`. A remaining `agent/instrumentation.ts` fails the build with a
+message directing you to the instrumentation directory.
+
+Before verifying a Vercel deployment, configure trace sampling. A deployed eve
+project needs at least one sampling rule with a rate above 0%; we recommend
+setting the rate to 100%. See
+[Enable tracing on Vercel](/docs/observability/otel#enable-tracing-on-vercel).
+
+Then run the agent and verify each destination independently.

package/docs/guides/instrumentation/otel.mdx

@@ -1,25 +1,22 @@
 ---
 title: "OpenTelemetry"
-description: "Configure OpenTelemetry destinations, content capture, and managed exports with Instrumentation Providers."
+description: "Configure OpenTelemetry destinations, content capture, and managed exports."
 url: "/observability/otel"
 ---
 
-<Callout type="warning" title="Experimental">
-  This API is experimental and may change without a deprecation period.
-</Callout>
-
-Use the built-in APIs from `eve/instrumentation/otel` to configure eve's
-OpenTelemetry pipeline. This page requires the experimental
-[Instrumentation Providers](./instrumentation-providers) layout.
+eve configures its built-in OpenTelemetry destinations automatically.
+`eve dev` records local traces, and preview and production deployments export
+to Vercel Agent Runs by default. You do not need `otel()` or
+`otelIntegration()` to use these defaults.
 
 ## Configure OpenTelemetry
 
-OpenTelemetry configuration has two parts:
+`otel()` and `otelIntegration()` are optional:
 
-- `otel()` declares process-wide settings such as the resource, sampler,
-  propagators, and trace capture policy. Declare it at most once.
-- `otelIntegration()` adds one destination. Declare one file per exporter or
-  processor chain.
+- Use `otel()` only when you need process-wide settings such as the resource,
+  sampler, propagators, or trace capture policy. Declare it at most once.
+- Use `otelIntegration()` only when adding a third-party OpenTelemetry
+  destination. Declare one file per exporter or processor chain.
 
 Add `agent/instrumentation/otel.ts` when you need process-wide settings or
 want to control the content eve writes to OpenTelemetry spans:
@@ -39,26 +36,67 @@ export default otel({
 
 The OpenTelemetry `tracePolicy` is a capture ceiling shared by every OTel
 destination. A destination cannot restore content excluded by this policy. It
-does not affect lifecycle-event providers created with `defineInstrumentation()`.
+does not affect lifecycle instrumentation created with `defineInstrumentation()`.
 See [Audience](../channels/overview#audience) for how channels classify the
 conversation passed to this policy.
 
 ## Add an OpenTelemetry destination
 
-Most agents only need a destination:
+Use this section when sending traces to a third-party destination. Install
+`@vercel/otel` before using its exporters:
+
+```bash
+pnpm add @vercel/otel
+```
 
-```ts title="agent/instrumentation/braintrust.ts"
-import { BraintrustExporter } from "@braintrust/otel";
+```ts title="agent/instrumentation/honeycomb.ts"
+import { OTLPHttpProtoTraceExporter } from "@vercel/otel";
 import { otelIntegration } from "eve/instrumentation/otel";
 
 export default otelIntegration({
-  traceExporter: new BraintrustExporter({ filterAISpans: true }),
+  exportPolicy: {
+    span: () => ({ redact: true, inputs: true, outputs: true }),
+  },
+  traceExporter: new OTLPHttpProtoTraceExporter({
+    url: "https://api.honeycomb.io/v1/traces",
+    headers: {
+      "x-honeycomb-team": process.env.HONEYCOMB_API_KEY!,
+    },
+  }),
 });
 ```
 
 Pass `spanProcessors` to `otelIntegration()` when a custom destination needs
-filtering or transformation. `exportPolicy` is for the built-in
-`localTraces()` and `agentRuns()` destinations below.
+filtering or transformation. The example's `exportPolicy` preserves span
+metadata while removing inputs and outputs from this destination.
+
+## Add runtime context
+
+Use `runtimeContext` to add JSON values to AI SDK spans for each model attempt.
+For typed channel metadata, import the channel definition and narrow with
+`isChannel`:
+
+```ts title="agent/instrumentation/support.ts"
+import { isChannel } from "eve/instrumentation";
+import { otelIntegration } from "eve/instrumentation/otel";
+
+import supportChannel from "../channels/support";
+
+export default otelIntegration({
+  runtimeContext(input) {
+    if (!isChannel(input.channel, supportChannel)) return undefined;
+
+    return {
+      "support.channel_id": input.channel.metadata.channelId ?? "",
+      "support.user_id": input.channel.metadata.triggeringUserId ?? "",
+    };
+  },
+});
+```
+
+The resolver receives the channel, session, final model input, step, and turn.
+Keys beginning with `eve.` are reserved. Content excluded by
+`otel({ tracePolicy })` is not available to the resolver.
 
 ## Trace topology
 
@@ -82,15 +120,13 @@ destination's span-search surface.
 
 ## Manage built-in destinations
 
-The provider layout has two environment-specific defaults:
+Instrumentation has two environment-specific defaults.
 
-- `local` records local traces during `eve dev`.
-- `agent-runs` exports to Vercel Agent Runs in preview and production
-  deployments.
+### Local traces
 
-Omitting these files preserves the defaults. Reconfigure a destination by
-exporting `localTraces()` or `agentRuns()` from the matching file. Disable one
-explicitly:
+`eve dev` records local traces by default. Omitting
+`agent/instrumentation/local.ts` preserves that default. Export
+`localTraces(...)` from that file to reconfigure it, or disable it explicitly:
 
 ```ts title="agent/instrumentation/local.ts"
 import { disableInstrumentation } from "eve/instrumentation";
@@ -98,11 +134,37 @@ import { disableInstrumentation } from "eve/instrumentation";
 export default disableInstrumentation();
 ```
 
-## Filter a managed destination
+### Vercel Agent Runs
+
+Preview and production deployments export to Vercel Agent Runs by default.
+Omitting `agent/instrumentation/agent-runs.ts` preserves that default. Export
+`agentRuns(...)` from that file to reconfigure it, or export
+`disableInstrumentation()` to disable it.
+
+## Enable tracing on Vercel
+
+A deployed eve project needs at least one
+[sampling rule with a rate above 0%](https://vercel.com/docs/tracing/always-on-tracing#enable-always-on-tracing)
+before Vercel collects traces. We recommend setting the rate to **100%** for
+eve projects so every matching request is traced.
+
+Select your team and project, then open
+[**Settings → Tracing**](https://vercel.com/d?to=%2F%5Bteam%5D%2F%5Bproject%5D%2Fsettings%2Ftracing&title=Go+to+Tracing+settings):
+
+1. Select **Add Sampling Rule**.
+2. Choose **All Environments**, **Production**, or **Preview**.
+3. Set **Rate** to `100%`.
+4. Select **Save**.
+
+Tracing starts as soon as you save the rule. You can also manage sampling
+rules with [`vercel traces config`](https://vercel.com/docs/cli/traces#manage-trace-sampling-rules).
+The CLI accepts rates from 1 to 100%; add a 0% rule from the dashboard.
+
+## Filter a destination
 
-`localTraces()` and `agentRuns()` accept one `exportPolicy` object or an array
-applied in order. Each policy filters spans and attributes before that
-destination's processors receive them:
+`otelIntegration()`, `localTraces()`, and `agentRuns()` accept one
+`exportPolicy` object or an array applied in order. Each policy filters spans
+and attributes before that destination's processors receive them:
 
 ```ts title="agent/instrumentation/agent-runs.ts"
 import { agentRuns } from "eve/instrumentation/otel";
@@ -153,6 +215,6 @@ before it.
 
 ## What to read next
 
-- [Instrumentation Providers](./instrumentation-providers): add lifecycle-event providers.
-- [Instrumentation](../observability/instrumentation): configure the current single-file API.
+- [Instrumentation](/docs/observability/instrumentation): handle eve lifecycle events.
+- [Migrate instrumentation](/docs/observability/instrumentation-migration): replace `agent/instrumentation.ts`.
 - [Local development](../guides/dev-tui): inspect local traces in the TUI.

package/docs/install-integrations.mdx

@@ -23,7 +23,7 @@ Web Chat installs a project-level Next.js application. It cannot be added to an
 
 If you do not know an item name yet, run `eve add` without an argument. Its help output shows how to search the registry with `eve registry search <query>`.
 
-Extensions may create a mount under `agent/extensions/`. Connections write their initial definition under `agent/connections/` and install `@vercel/connect` when required. Instrumentation providers write `agent/instrumentation.ts`; because an agent has one instrumentation file, compose multiple exporters there by hand. Configure generated files and required environment variables before running your agent.
+Extensions may create a mount under `agent/extensions/`. Connections write their initial definition under `agent/connections/` and install `@vercel/connect` when required. Instrumentation integrations write one destination file under `agent/instrumentation/`, so you can install and configure multiple exporters independently. Configure generated files and required environment variables before running your agent.
 
 When an official item declares an interactive setup flow or flows, eve asks whether to run them after installation and runs multiple flows in declaration order. Run the printed `eve add <item> --skip-install` command to resume a skipped or cancelled setup later; it reruns the item's declared flows from the beginning.
 

package/docs/reference/agent-files.md

@@ -13,7 +13,7 @@ In a single-agent project, the agent directory is `agent/`. In an eve agent work
 agent/
 ├── agent.ts
 ├── instructions.md
-├── instrumentation.ts
+├── instrumentation/
 ├── channels/
 ├── connections/
 ├── extensions/
@@ -50,7 +50,7 @@ Paths below are relative to the agent directory. Root agents can use every path;
 | ------------------------------------------------------- | ----------------------------------------- | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
 | `agent.ts`                                              | Runtime config                            | Yes                    | Model, model options, compaction, build, and experimental settings. See [Agents](/docs/agent-config).                                   |
 | `instructions.md` / `instructions.ts` / `instructions/` | Base system prompt                        | Yes                    | A flat file or directory of `.md` and `.ts` files. Required on the root, optional on subagents. See [Instructions](/docs/instructions). |
-| `instrumentation.ts`                                    | Telemetry config                          | No                     | Auto-discovered and run before agent code. See [Instrumentation](/docs/observability/instrumentation).                                  |
+| `instrumentation/`                                      | Telemetry providers and destinations      | No                     | One path-named provider per file. See [Instrumentation](/docs/observability/instrumentation).                                           |
 | `channels/`                                             | HTTP and messaging entry points           | No                     | See [Channels](/docs/channels/overview).                                                                                                |
 | `connections/`                                          | External MCP and OpenAPI services         | Yes                    | Static files define path-named connections; dynamic sources can resolve caller-specific connections.                                    |
 | `extensions/`                                           | Mounted reusable capabilities             | Yes                    | File or directory mounts. See [Extensions](/docs/extensions).                                                                           |

package/docs/reference/cli.md

@@ -272,7 +272,7 @@ Local dev records the last ready URL per resolved app root in `.eve/dev-server-s
 
 Local dev keeps immutable runtime generations under `.eve/dev-runtime/snapshots/` so in-flight turns hold a consistent code revision while new turns pick up rebuilds. Each generation contains the compiled authored module graph and runtime resources rather than a recursive copy of the app or workspace. The terminal REPL keeps its logical session across successful rebuilds, so the next turn continues the conversation on the latest generation; `/new` terminally retires that session before clearing the transcript, and the next prompt starts a fresh session with a new session-scoped sandbox on first sandbox use. After a generation is superseded, `eve dev` retains it for at least 30 minutes and also retains the five most recently superseded generations, regardless of the configured Workflow World. The active generation is never pruned. Old runtime snapshots and local sandbox templates are pruned in the background. For manual cleanup, stop `eve dev` before deleting `.eve/dev-runtime/snapshots/` or `.eve/sandbox-cache/local/templates/`. A turn that remains unfinished beyond the automatic retention window can no longer resume after its generation is pruned.
 
-When no authored `agent/instrumentation.ts` exists, local dev also records traces under `.eve/traces/`, and bounds that store by age, size, and a keep-newest floor. Configure it with `EVE_TRACES*` in `.env.local`; see [`eve traces`](#retention) for the rules and defaults.
+Local development records traces under `.eve/traces/` by default and bounds that store by age, size, and a keep-newest floor. Configure it with `EVE_TRACES*` in `.env.local`, or disable the destination with `agent/instrumentation/local.ts`; see [`eve traces`](#retention) for the rules and defaults.
 
 ## `eve logs`
 

package/docs/reference/typescript-api.md

@@ -49,7 +49,8 @@ export default defineTool({
 | `defineSchedule`                                      | `eve/schedules`                                                         | `agent/schedules/<name>.ts`                                                            | [Schedules](../schedules)                              |
 | `defineState`                                         | `eve/context`                                                           | tools, hooks, lifecycle                                                                | [Session context](../guides/session-context)           |
 | `defineSandbox`                                       | `eve/sandbox`                                                           | `agent/sandbox.ts`                                                                     | [Sandbox](../sandbox)                                  |
-| `defineInstrumentation`                               | `eve/instrumentation`                                                   | `agent/instrumentation.ts`                                                             | [Instrumentation](../observability/instrumentation)    |
+| `defineInstrumentation`                               | `eve/instrumentation`                                                   | `agent/instrumentation/<name>.ts`                                                      | [Instrumentation](../observability/instrumentation)    |
+| `otel`, `otelIntegration`                             | `eve/instrumentation/otel`                                              | `agent/instrumentation/<destination>.ts`                                               | [OpenTelemetry](../observability/otel)                 |
 | `defineRemoteAgent`                                   | `eve`                                                                   | `agent/subagents/<id>/agent.ts`                                                        | [Remote agents](../guides/remote-agents)               |
 | `defineEval`                                          | `eve/evals`                                                             | `evals/*.eval.ts`                                                                      | [Evals](../evals/overview)                             |
 | `defineEvalConfig`                                    | `eve/evals`                                                             | `evals/evals.config.ts`                                                                | [Evals](../evals/overview)                             |
@@ -136,7 +137,8 @@ Tool definitions accept `availableInSubagents: false` to restrict the tool to to
 | `eve/memory/file/vercel`                                                    | `vercelBlob` and Vercel Blob backend options                                                                                   |
 | `eve/context`                                                               | `defineState`, session and state types                                                                                         |
 | `eve/sandbox`                                                               | `defineSandbox`, backends                                                                                                      |
-| `eve/instrumentation`                                                       | `defineInstrumentation`, `isChannel`                                                                                           |
+| `eve/instrumentation`                                                       | `defineInstrumentation`, `disableInstrumentation`, `isChannel`, lifecycle provider types                                       |
+| `eve/instrumentation/otel`                                                  | `otel`, `otelIntegration`, `localTraces`, `agentRuns`, OpenTelemetry policy types                                              |
 | `eve/local-dev`                                                             | `getLocalDevCapability`, `LocalDevCapability`                                                                                  |
 | [`eve/models`](../guides/evaluate)                                          | Automatic model selection with `auto`                                                                                          |
 | `eve/models/openai`                                                         | `openai`, `chatgpt`, deprecated `experimental_chatgpt`                                                                         |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eve",
-  "version": "0.61.1",
+  "version": "0.62.0",
   "private": false,
   "description": "Filesystem-first framework for durable backend AI agents that run anywhere.",
   "keywords": [
@@ -505,7 +505,6 @@
     "@workflow/world-local": "5.0.0-beta.45",
     "@workflow/world-vercel": "5.0.0-beta.48",
     "ai": "^7.0.105",
-    "autoevals": "0.0.132",
     "chat": "4.34.0",
     "chokidar": "5.0.0",
     "commander": "14.0.3",

package/dist/src/compiler/instrumentation-layout-config.d.ts

@@ -1,3 +0,0 @@
-import type { CompiledAgentDefinition } from "#compiler/manifest.js";
-import type { FinalizedNodeSourceState } from "#compiler/node-source-state.js";
-export declare function assertInstrumentationLayoutConfig(config: CompiledAgentDefinition, state: FinalizedNodeSourceState): void;

package/dist/src/compiler/instrumentation-layout-config.js

@@ -1 +0,0 @@
-function assertInstrumentationLayoutConfig(e,t){if(e.experimental?.instrumentationProviders===!0&&t.composed.selected.has(`instrumentation`))throw Error(`A selected instrumentation.ts source cannot be used with experimental.instrumentationProviders. Move the declaration into the instrumentation/ provider directory.`)}export{assertInstrumentationLayoutConfig};

package/dist/src/evals/autoevals-client.d.ts

@@ -1,14 +0,0 @@
-import { generateText, type LanguageModel } from "ai";
-import { Factuality } from "autoevals";
-/**
- * The OpenAI-shaped client surface autoevals expects. Extracted from the
- * library so we don't take a direct dependency on `openai` types.
- */
-type AutoevalsClient = NonNullable<Parameters<typeof Factuality>[0]["client"]>;
-type ProviderOptions = Parameters<typeof generateText>[0]["providerOptions"];
-interface AutoevalsClientConfig {
-    readonly languageModel: LanguageModel;
-    readonly providerOptions?: ProviderOptions;
-}
-export declare function createAutoevalsClient(config: AutoevalsClientConfig): AutoevalsClient;
-export {};

package/dist/src/evals/autoevals-client.js

@@ -1,2 +0,0 @@
-import"../node_modules/.pnpm/autoevals@0.0.132_@smithy_signature-v4@5.7.3_ws@8.21.3_bufferutil@4.1.0_/node_modules/autoevals/jsdist/index.js";import{generateText}from"ai";import{toInputSchema}from"#tools/schema.js";import{resolveProviderHeaders}from"#internal/gateway.js";var AutoevalsOpenAIClientAdapter=class{chat;constructor(e){this.chat={completions:{create:isAutoevalsClientConfig(e)?t=>createChatCompletion(t,e):createProbeChatCompletion}}}};function createAutoevalsClient(e){return new AutoevalsOpenAIClientAdapter(e)}function isAutoevalsClientConfig(e){return`languageModel`in e}async function createProbeChatCompletion(){return{choices:[]}}async function createChatCompletion(e,t){let n=convertTools(e.tools),r=await generateText({headers:resolveProviderHeaders(t.languageModel),model:t.languageModel,messages:convertMessages(e.messages??[]),tools:Object.keys(n).length>0?n:void 0,toolChoice:convertToolChoice(e.tool_choice),providerOptions:t.providerOptions}),i=r.toolCalls.map(e=>({id:e.toolCallId,type:`function`,function:{name:e.toolName,arguments:JSON.stringify(e.input??{})}}));return{choices:[{index:0,finish_reason:i.length>0?`tool_calls`:`stop`,message:{role:`assistant`,content:r.text||null,tool_calls:i.length>0?i:void 0}}]}}function convertMessages(e){return e.map(e=>{let t=contentToText(e.content);switch(e.role){case`assistant`:return{role:`assistant`,content:t};case`developer`:case`system`:return{role:`system`,content:t};default:return{role:`user`,content:t}}})}function contentToText(e){return e==null?``:typeof e==`string`?e:e.map(e=>e.text??``).filter(Boolean).join(`
-`)}function convertTools(e){let t={};for(let n of e??[])n.type===`function`&&n.function?.name!==void 0&&(t[n.function.name]={description:n.function.description,inputSchema:toInputSchema(n.function.parameters??{})});return t}function convertToolChoice(e){if(e!==void 0)return typeof e==`string`?e:{type:`tool`,toolName:e.function.name}}export{createAutoevalsClient};

package/dist/src/instrumentation/config.d.ts

@@ -1,13 +0,0 @@
-import type { InstrumentationDefinition } from "#public/instrumentation/index.js";
-/**
- * Registers the authored instrumentation config and awaits its `setup`
- * callback.
- *
- * Called once by the generated instrumentation Nitro plugin at server
- * startup. Subsequent calls overwrite the previous value.
- *
- * @internal — not part of the public API.
- */
-export declare function registerInstrumentationConfig(config: InstrumentationDefinition, input: {
-    readonly agentName: string;
-}): Promise<void>;

package/dist/src/instrumentation/config.js

@@ -1 +0,0 @@
-import{registerInstrumentationRuntime}from"#instrumentation/runtime.js";import{createInstrumentationHooks}from"#instrumentation/lifecycle.js";import{createInstrumentationSetupContext}from"#instrumentation/setup-context.js";async function registerInstrumentationConfig(e,t){let n=registerInstrumentationRuntime({forceFlush:async()=>void 0,hooks:createInstrumentationHooks([]),otelSettings:{functionId:e.functionId,recordInputs:e.recordInputs===!0,recordOutputs:e.recordOutputs===!0,traceChannelRequests:e.traceChannelRequests===!0},runInContext:(e,t)=>t(),shutdown:async()=>void 0});n.stepStartedRuntimeContextResolver=t=>e.events?.[`step.started`]?.(t),await e.setup?.(createInstrumentationSetupContext(t.agentName))}export{registerInstrumentationConfig};

package/dist/src/node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/ajv.js

@@ -1 +0,0 @@
-import{__commonJSMin}from"../../../../../../_virtual/_rolldown/runtime.js";import{require_codegen}from"./compile/codegen/index.js";import{require_validate}from"./compile/validate/index.js";import{require_validation_error}from"./runtime/validation_error.js";import{require_ref_error}from"./compile/ref_error.js";import{require_core}from"./core.js";import{require_draft7}from"./vocabularies/draft7.js";import{require_discriminator}from"./vocabularies/discriminator/index.js";import{require_json_schema_draft_07}from"./refs/json-schema-draft-07.js";var require_ajv=__commonJSMin(((e,t)=>{Object.defineProperty(e,"__esModule",{value:!0}),e.MissingRefError=e.ValidationError=e.CodeGen=e.Name=e.nil=e.stringify=e.str=e._=e.KeywordCxt=e.Ajv=void 0;let n=require_core(),r=require_draft7(),i=require_discriminator(),a=require_json_schema_draft_07(),o=[`/properties`],s=`http://json-schema.org/draft-07/schema`;var Ajv=class extends n.default{_addVocabularies(){super._addVocabularies(),r.default.forEach(e=>this.addVocabulary(e)),this.opts.discriminator&&this.addKeyword(i.default)}_addDefaultMetaSchema(){if(super._addDefaultMetaSchema(),!this.opts.meta)return;let e=this.opts.$data?this.$dataMetaSchema(a,o):a;this.addMetaSchema(e,s,!1),this.refs[`http://json-schema.org/schema`]=s}defaultMeta(){return this.opts.defaultMeta=super.defaultMeta()||(this.getSchema(s)?s:void 0)}};e.Ajv=Ajv,t.exports=e=Ajv,t.exports.Ajv=Ajv,Object.defineProperty(e,"__esModule",{value:!0}),e.default=Ajv;var c=require_validate();Object.defineProperty(e,"KeywordCxt",{enumerable:!0,get:function(){return c.KeywordCxt}});var l=require_codegen();Object.defineProperty(e,"_",{enumerable:!0,get:function(){return l._}}),Object.defineProperty(e,"str",{enumerable:!0,get:function(){return l.str}}),Object.defineProperty(e,"stringify",{enumerable:!0,get:function(){return l.stringify}}),Object.defineProperty(e,"nil",{enumerable:!0,get:function(){return l.nil}}),Object.defineProperty(e,"Name",{enumerable:!0,get:function(){return l.Name}}),Object.defineProperty(e,"CodeGen",{enumerable:!0,get:function(){return l.CodeGen}});var u=require_validation_error();Object.defineProperty(e,"ValidationError",{enumerable:!0,get:function(){return u.default}});var d=require_ref_error();Object.defineProperty(e,"MissingRefError",{enumerable:!0,get:function(){return d.default}})}));export default require_ajv();export{require_ajv};

package/dist/src/node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/codegen/code.js

@@ -1 +0,0 @@
-import{__commonJSMin}from"../../../../../../../../_virtual/_rolldown/runtime.js";var require_code=__commonJSMin((e=>{Object.defineProperty(e,"__esModule",{value:!0}),e.regexpCode=e.getEsmExportName=e.getProperty=e.safeStringify=e.stringify=e.strConcat=e.addCodeArg=e.str=e._=e.nil=e._Code=e.Name=e.IDENTIFIER=e._CodeOrName=void 0;var _CodeOrName=class{};e._CodeOrName=_CodeOrName,e.IDENTIFIER=/^[a-z$_][a-z$_0-9]*$/i;var Name=class extends _CodeOrName{constructor(t){if(super(),!e.IDENTIFIER.test(t))throw Error(`CodeGen: name must be a valid identifier`);this.str=t}toString(){return this.str}emptyStr(){return!1}get names(){return{[this.str]:1}}};e.Name=Name;var _Code=class extends _CodeOrName{constructor(e){super(),this._items=typeof e==`string`?[e]:e}toString(){return this.str}emptyStr(){if(this._items.length>1)return!1;let e=this._items[0];return e===``||e===`""`}get str(){return this._str??=this._items.reduce((e,t)=>`${e}${t}`,``)}get names(){return this._names??=this._items.reduce((e,t)=>(t instanceof Name&&(e[t.str]=(e[t.str]||0)+1),e),{})}};e._Code=_Code,e.nil=new _Code(``);function _(e,...t){let n=[e[0]],r=0;for(;r<t.length;)addCodeArg(n,t[r]),n.push(e[++r]);return new _Code(n)}e._=_;let t=new _Code(`+`);function str(e,...n){let r=[safeStringify(e[0])],i=0;for(;i<n.length;)r.push(t),addCodeArg(r,n[i]),r.push(t,safeStringify(e[++i]));return optimize(r),new _Code(r)}e.str=str;function addCodeArg(e,t){t instanceof _Code?e.push(...t._items):t instanceof Name?e.push(t):e.push(interpolate(t))}e.addCodeArg=addCodeArg;function optimize(e){let n=1;for(;n<e.length-1;){if(e[n]===t){let t=mergeExprItems(e[n-1],e[n+1]);if(t!==void 0){e.splice(n-1,3,t);continue}e[n++]=`+`}n++}}function mergeExprItems(e,t){if(t===`""`)return e;if(e===`""`)return t;if(typeof e==`string`)return t instanceof Name||e[e.length-1]!==`"`?void 0:typeof t==`string`?t[0]===`"`?e.slice(0,-1)+t.slice(1):void 0:`${e.slice(0,-1)}${t}"`;if(typeof t==`string`&&t[0]===`"`&&!(e instanceof Name))return`"${e}${t.slice(1)}`}function strConcat(e,t){return t.emptyStr()?e:e.emptyStr()?t:str`${e}${t}`}e.strConcat=strConcat;function interpolate(e){return typeof e==`number`||typeof e==`boolean`||e===null?e:safeStringify(Array.isArray(e)?e.join(`,`):e)}function stringify(e){return new _Code(safeStringify(e))}e.stringify=stringify;function safeStringify(e){return JSON.stringify(e).replace(/\u2028/g,`\\u2028`).replace(/\u2029/g,`\\u2029`)}e.safeStringify=safeStringify;function getProperty(t){return typeof t==`string`&&e.IDENTIFIER.test(t)?new _Code(`.${t}`):_`[${t}]`}e.getProperty=getProperty;function getEsmExportName(t){if(typeof t==`string`&&e.IDENTIFIER.test(t))return new _Code(`${t}`);throw Error(`CodeGen: invalid export name: ${t}, use explicit $id name mapping`)}e.getEsmExportName=getEsmExportName;function regexpCode(e){return new _Code(e.toString())}e.regexpCode=regexpCode}));export default require_code();export{require_code};

package/dist/src/node_modules/.pnpm/ajv@8.20.0/node_modules/ajv/dist/compile/codegen/index.js

@@ -1,2 +0,0 @@
-import{__commonJSMin}from"../../../../../../../../_virtual/_rolldown/runtime.js";import{require_code}from"./code.js";import{require_scope}from"./scope.js";var require_codegen=__commonJSMin((e=>{Object.defineProperty(e,"__esModule",{value:!0}),e.or=e.and=e.not=e.CodeGen=e.operators=e.varKinds=e.ValueScopeName=e.ValueScope=e.Scope=e.Name=e.regexpCode=e.stringify=e.getProperty=e.nil=e.strConcat=e.str=e._=void 0;let t=require_code(),n=require_scope();var r=require_code();Object.defineProperty(e,"_",{enumerable:!0,get:function(){return r._}}),Object.defineProperty(e,"str",{enumerable:!0,get:function(){return r.str}}),Object.defineProperty(e,"strConcat",{enumerable:!0,get:function(){return r.strConcat}}),Object.defineProperty(e,"nil",{enumerable:!0,get:function(){return r.nil}}),Object.defineProperty(e,"getProperty",{enumerable:!0,get:function(){return r.getProperty}}),Object.defineProperty(e,"stringify",{enumerable:!0,get:function(){return r.stringify}}),Object.defineProperty(e,"regexpCode",{enumerable:!0,get:function(){return r.regexpCode}}),Object.defineProperty(e,"Name",{enumerable:!0,get:function(){return r.Name}});var i=require_scope();Object.defineProperty(e,"Scope",{enumerable:!0,get:function(){return i.Scope}}),Object.defineProperty(e,"ValueScope",{enumerable:!0,get:function(){return i.ValueScope}}),Object.defineProperty(e,"ValueScopeName",{enumerable:!0,get:function(){return i.ValueScopeName}}),Object.defineProperty(e,"varKinds",{enumerable:!0,get:function(){return i.varKinds}}),e.operators={GT:new t._Code(`>`),GTE:new t._Code(`>=`),LT:new t._Code(`<`),LTE:new t._Code(`<=`),EQ:new t._Code(`===`),NEQ:new t._Code(`!==`),NOT:new t._Code(`!`),OR:new t._Code(`||`),AND:new t._Code(`&&`),ADD:new t._Code(`+`)};var Node=class{optimizeNodes(){return this}optimizeNames(e,t){return this}},Def=class extends Node{constructor(e,t,n){super(),this.varKind=e,this.name=t,this.rhs=n}render({es5:e,_n:t}){let r=e?n.varKinds.var:this.varKind,i=this.rhs===void 0?``:` = ${this.rhs}`;return`${r} ${this.name}${i};`+t}optimizeNames(e,t){if(e[this.name.str])return this.rhs&&=optimizeExpr(this.rhs,e,t),this}get names(){return this.rhs instanceof t._CodeOrName?this.rhs.names:{}}},Assign=class extends Node{constructor(e,t,n){super(),this.lhs=e,this.rhs=t,this.sideEffects=n}render({_n:e}){return`${this.lhs} = ${this.rhs};`+e}optimizeNames(e,n){if(!(this.lhs instanceof t.Name&&!e[this.lhs.str]&&!this.sideEffects))return this.rhs=optimizeExpr(this.rhs,e,n),this}get names(){return addExprNames(this.lhs instanceof t.Name?{}:{...this.lhs.names},this.rhs)}},AssignOp=class extends Assign{constructor(e,t,n,r){super(e,n,r),this.op=t}render({_n:e}){return`${this.lhs} ${this.op}= ${this.rhs};`+e}},Label=class extends Node{constructor(e){super(),this.label=e,this.names={}}render({_n:e}){return`${this.label}:`+e}},Break=class extends Node{constructor(e){super(),this.label=e,this.names={}}render({_n:e}){return`break${this.label?` ${this.label}`:``};`+e}},Throw=class extends Node{constructor(e){super(),this.error=e}render({_n:e}){return`throw ${this.error};`+e}get names(){return this.error.names}},AnyCode=class extends Node{constructor(e){super(),this.code=e}render({_n:e}){return`${this.code};`+e}optimizeNodes(){return`${this.code}`?this:void 0}optimizeNames(e,t){return this.code=optimizeExpr(this.code,e,t),this}get names(){return this.code instanceof t._CodeOrName?this.code.names:{}}},ParentNode=class extends Node{constructor(e=[]){super(),this.nodes=e}render(e){return this.nodes.reduce((t,n)=>t+n.render(e),``)}optimizeNodes(){let{nodes:e}=this,t=e.length;for(;t--;){let n=e[t].optimizeNodes();Array.isArray(n)?e.splice(t,1,...n):n?e[t]=n:e.splice(t,1)}return e.length>0?this:void 0}optimizeNames(e,t){let{nodes:n}=this,r=n.length;for(;r--;){let i=n[r];i.optimizeNames(e,t)||(subtractNames(e,i.names),n.splice(r,1))}return n.length>0?this:void 0}get names(){return this.nodes.reduce((e,t)=>addNames(e,t.names),{})}},BlockNode=class extends ParentNode{render(e){return`{`+e._n+super.render(e)+`}`+e._n}},Root=class extends ParentNode{},Else=class extends BlockNode{};Else.kind=`else`;var a=class If extends BlockNode{constructor(e,t){super(t),this.condition=e}render(e){let t=`if(${this.condition})`+super.render(e);return this.else&&(t+=`else `+this.else.render(e)),t}optimizeNodes(){super.optimizeNodes();let e=this.condition;if(e===!0)return this.nodes;let t=this.else;if(t){let e=t.optimizeNodes();t=this.else=Array.isArray(e)?new Else(e):e}if(t)return e===!1?t instanceof If?t:t.nodes:this.nodes.length?this:new If(not(e),t instanceof If?[t]:t.nodes);if(e!==!1&&this.nodes.length)return this}optimizeNames(e,t){if(this.else=this.else?.optimizeNames(e,t),super.optimizeNames(e,t)||this.else)return this.condition=optimizeExpr(this.condition,e,t),this}get names(){let e=super.names;return addExprNames(e,this.condition),this.else&&addNames(e,this.else.names),e}};a.kind=`if`;var For=class extends BlockNode{};For.kind=`for`;var ForLoop=class extends For{constructor(e){super(),this.iteration=e}render(e){return`for(${this.iteration})`+super.render(e)}optimizeNames(e,t){if(super.optimizeNames(e,t))return this.iteration=optimizeExpr(this.iteration,e,t),this}get names(){return addNames(super.names,this.iteration.names)}},ForRange=class extends For{constructor(e,t,n,r){super(),this.varKind=e,this.name=t,this.from=n,this.to=r}render(e){let t=e.es5?n.varKinds.var:this.varKind,{name:r,from:i,to:a}=this;return`for(${t} ${r}=${i}; ${r}<${a}; ${r}++)`+super.render(e)}get names(){return addExprNames(addExprNames(super.names,this.from),this.to)}},ForIter=class extends For{constructor(e,t,n,r){super(),this.loop=e,this.varKind=t,this.name=n,this.iterable=r}render(e){return`for(${this.varKind} ${this.name} ${this.loop} ${this.iterable})`+super.render(e)}optimizeNames(e,t){if(super.optimizeNames(e,t))return this.iterable=optimizeExpr(this.iterable,e,t),this}get names(){return addNames(super.names,this.iterable.names)}},Func=class extends BlockNode{constructor(e,t,n){super(),this.name=e,this.args=t,this.async=n}render(e){return`${this.async?`async `:``}function ${this.name}(${this.args})`+super.render(e)}};Func.kind=`func`;var Return=class extends ParentNode{render(e){return`return `+super.render(e)}};Return.kind=`return`;var Try=class extends BlockNode{render(e){let t=`try`+super.render(e);return this.catch&&(t+=this.catch.render(e)),this.finally&&(t+=this.finally.render(e)),t}optimizeNodes(){return super.optimizeNodes(),this.catch?.optimizeNodes(),this.finally?.optimizeNodes(),this}optimizeNames(e,t){return super.optimizeNames(e,t),this.catch?.optimizeNames(e,t),this.finally?.optimizeNames(e,t),this}get names(){let e=super.names;return this.catch&&addNames(e,this.catch.names),this.finally&&addNames(e,this.finally.names),e}},Catch=class extends BlockNode{constructor(e){super(),this.error=e}render(e){return`catch(${this.error})`+super.render(e)}};Catch.kind=`catch`;var Finally=class extends BlockNode{render(e){return`finally`+super.render(e)}};Finally.kind=`finally`,e.CodeGen=class{constructor(e,t={}){this._values={},this._blockStarts=[],this._constants={},this.opts={...t,_n:t.lines?`
-`:``},this._extScope=e,this._scope=new n.Scope({parent:e}),this._nodes=[new Root]}toString(){return this._root.render(this.opts)}name(e){return this._scope.name(e)}scopeName(e){return this._extScope.name(e)}scopeValue(e,t){let n=this._extScope.value(e,t);return(this._values[n.prefix]||(this._values[n.prefix]=new Set)).add(n),n}getScopeValue(e,t){return this._extScope.getValue(e,t)}scopeRefs(e){return this._extScope.scopeRefs(e,this._values)}scopeCode(){return this._extScope.scopeCode(this._values)}_def(e,t,n,r){let i=this._scope.toName(t);return n!==void 0&&r&&(this._constants[i.str]=n),this._leafNode(new Def(e,i,n)),i}const(e,t,r){return this._def(n.varKinds.const,e,t,r)}let(e,t,r){return this._def(n.varKinds.let,e,t,r)}var(e,t,r){return this._def(n.varKinds.var,e,t,r)}assign(e,t,n){return this._leafNode(new Assign(e,t,n))}add(t,n){return this._leafNode(new AssignOp(t,e.operators.ADD,n))}code(e){return typeof e==`function`?e():e!==t.nil&&this._leafNode(new AnyCode(e)),this}object(...e){let n=[`{`];for(let[r,i]of e)n.length>1&&n.push(`,`),n.push(r),(r!==i||this.opts.es5)&&(n.push(`:`),(0,t.addCodeArg)(n,i));return n.push(`}`),new t._Code(n)}if(e,t,n){if(this._blockNode(new a(e)),t&&n)this.code(t).else().code(n).endIf();else if(t)this.code(t).endIf();else if(n)throw Error(`CodeGen: "else" body without "then" body`);return this}elseIf(e){return this._elseNode(new a(e))}else(){return this._elseNode(new Else)}endIf(){return this._endBlockNode(a,Else)}_for(e,t){return this._blockNode(e),t&&this.code(t).endFor(),this}for(e,t){return this._for(new ForLoop(e),t)}forRange(e,t,r,i,a=this.opts.es5?n.varKinds.var:n.varKinds.let){let o=this._scope.toName(e);return this._for(new ForRange(a,o,t,r),()=>i(o))}forOf(e,r,i,a=n.varKinds.const){let o=this._scope.toName(e);if(this.opts.es5){let e=r instanceof t.Name?r:this.var(`_arr`,r);return this.forRange(`_i`,0,(0,t._)`${e}.length`,n=>{this.var(o,(0,t._)`${e}[${n}]`),i(o)})}return this._for(new ForIter(`of`,a,o,r),()=>i(o))}forIn(e,r,i,a=this.opts.es5?n.varKinds.var:n.varKinds.const){if(this.opts.ownProperties)return this.forOf(e,(0,t._)`Object.keys(${r})`,i);let o=this._scope.toName(e);return this._for(new ForIter(`in`,a,o,r),()=>i(o))}endFor(){return this._endBlockNode(For)}label(e){return this._leafNode(new Label(e))}break(e){return this._leafNode(new Break(e))}return(e){let t=new Return;if(this._blockNode(t),this.code(e),t.nodes.length!==1)throw Error(`CodeGen: "return" should have one node`);return this._endBlockNode(Return)}try(e,t,n){if(!t&&!n)throw Error(`CodeGen: "try" without "catch" and "finally"`);let r=new Try;if(this._blockNode(r),this.code(e),t){let e=this.name(`e`);this._currNode=r.catch=new Catch(e),t(e)}return n&&(this._currNode=r.finally=new Finally,this.code(n)),this._endBlockNode(Catch,Finally)}throw(e){return this._leafNode(new Throw(e))}block(e,t){return this._blockStarts.push(this._nodes.length),e&&this.code(e).endBlock(t),this}endBlock(e){let t=this._blockStarts.pop();if(t===void 0)throw Error(`CodeGen: not in self-balancing block`);let n=this._nodes.length-t;if(n<0||e!==void 0&&n!==e)throw Error(`CodeGen: wrong number of nodes: ${n} vs ${e} expected`);return this._nodes.length=t,this}func(e,n=t.nil,r,i){return this._blockNode(new Func(e,n,r)),i&&this.code(i).endFunc(),this}endFunc(){return this._endBlockNode(Func)}optimize(e=1){for(;e-->0;)this._root.optimizeNodes(),this._root.optimizeNames(this._root.names,this._constants)}_leafNode(e){return this._currNode.nodes.push(e),this}_blockNode(e){this._currNode.nodes.push(e),this._nodes.push(e)}_endBlockNode(e,t){let n=this._currNode;if(n instanceof e||t&&n instanceof t)return this._nodes.pop(),this;throw Error(`CodeGen: not in block "${t?`${e.kind}/${t.kind}`:e.kind}"`)}_elseNode(e){let t=this._currNode;if(!(t instanceof a))throw Error(`CodeGen: "else" without "if"`);return this._currNode=t.else=e,this}get _root(){return this._nodes[0]}get _currNode(){let e=this._nodes;return e[e.length-1]}set _currNode(e){let t=this._nodes;t[t.length-1]=e}};function addNames(e,t){for(let n in t)e[n]=(e[n]||0)+(t[n]||0);return e}function addExprNames(e,n){return n instanceof t._CodeOrName?addNames(e,n.names):e}function optimizeExpr(e,n,r){return e instanceof t.Name?replaceName(e):canOptimize(e)?new t._Code(e._items.reduce((e,n)=>(n instanceof t.Name&&(n=replaceName(n)),n instanceof t._Code?e.push(...n._items):e.push(n),e),[])):e;function replaceName(e){let t=r[e.str];return t===void 0||n[e.str]!==1?e:(delete n[e.str],t)}function canOptimize(e){return e instanceof t._Code&&e._items.some(e=>e instanceof t.Name&&n[e.str]===1&&r[e.str]!==void 0)}}function subtractNames(e,t){for(let n in t)e[n]=(e[n]||0)-(t[n]||0)}function not(e){return typeof e==`boolean`||typeof e==`number`||e===null?!e:(0,t._)`!${par(e)}`}e.not=not;let o=mappend(e.operators.AND);function and(...e){return e.reduce(o)}e.and=and;let s=mappend(e.operators.OR);function or(...e){return e.reduce(s)}e.or=or;function mappend(e){return(n,r)=>n===t.nil?r:r===t.nil?n:(0,t._)`${par(n)} ${e} ${par(r)}`}function par(e){return e instanceof t.Name?e:(0,t._)`(${e})`}}));export default require_codegen();export{require_codegen};