eve 0.85.0 → 0.87.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +34 -3073
- package/README.md +7 -4
- package/dist/src/acp/adapter.d.ts +2 -26
- package/dist/src/acp/adapter.js +1 -1
- package/dist/src/acp/server.d.ts +0 -3
- package/dist/src/ai/decision-adapter.d.ts +5 -3
- package/dist/src/ai/decision-adapter.js +1 -1
- package/dist/src/ai/decision-types.d.ts +4 -3
- package/dist/src/channel/adapter.d.ts +0 -14
- package/dist/src/channel/auth/definitions.d.ts +0 -4
- package/dist/src/channel/channel-address.d.ts +1 -1
- package/dist/src/channel/channel-address.js +1 -1
- package/dist/src/channel/channel-operations.d.ts +2 -2
- package/dist/src/channel/channel-operations.js +1 -1
- package/dist/src/channel/prompt-queue.d.ts +0 -2
- package/dist/src/channel/session-not-active-error.d.ts +10 -5
- package/dist/src/channel/session-not-active-error.js +1 -1
- package/dist/src/channel/session-stranded-error.d.ts +1 -1
- package/dist/src/channel/session.d.ts +3 -4
- package/dist/src/channel/session.js +1 -1
- package/dist/src/channel/types.d.ts +5 -14
- package/dist/src/chunks/{use-eve-agent-B2jCfcnG.js → use-eve-agent-BExXjBv6.js} +82 -72
- package/dist/src/chunks/{use-eve-agent-DCLFi26P.js → use-eve-agent-C0KHCyb9.js} +82 -72
- package/dist/src/cli/commands/agent-prompt/collect-intent.md +2 -1
- package/dist/src/cli/commands/agent-prompt/scaffold.md +1 -2
- package/dist/src/cli/dev/command-options.d.ts +4 -4
- package/dist/src/cli/dev/command.js +1 -1
- package/dist/src/cli/dev/tui/runner.d.ts +1 -1
- package/dist/src/cli/dev/tui/runner.js +2 -2
- package/dist/src/cli/dev/tui/test/fake-eve-server.js +1 -1
- package/dist/src/cli/dev/tui/tool-format.d.ts +2 -2
- package/dist/src/cli/dev/ui-options.d.ts +4 -4
- package/dist/src/cli/dev/ui-options.js +1 -1
- package/dist/src/cli/run.js +1 -1
- package/dist/src/client/agent-info-error.d.ts +4 -1
- package/dist/src/client/agent-info-error.js +1 -1
- package/dist/src/client/agent-session.d.ts +1 -4
- package/dist/src/client/agent-session.js +1 -1
- package/dist/src/client/agent-stream-follower.js +1 -1
- package/dist/src/client/client-error.d.ts +13 -4
- package/dist/src/client/client-error.js +1 -1
- package/dist/src/client/delivery.d.ts +2 -17
- package/dist/src/client/health-response-error.d.ts +4 -1
- package/dist/src/client/health-response-error.js +1 -1
- package/dist/src/client/index.d.ts +5 -3
- package/dist/src/client/index.js +1 -1
- package/dist/src/client/open-stream.d.ts +7 -12
- package/dist/src/client/open-stream.js +1 -1
- package/dist/src/client/session-controls.d.ts +2 -2
- package/dist/src/client/session-controls.js +1 -1
- package/dist/src/client/session-event-stream.d.ts +2 -2
- package/dist/src/client/session-event-stream.js +1 -1
- package/dist/src/client/session-store.d.ts +2 -6
- package/dist/src/client/session-store.js +1 -1
- package/dist/src/client/session.d.ts +4 -13
- package/dist/src/client/session.js +1 -1
- package/dist/src/client/sessions.d.ts +3 -6
- package/dist/src/client/types.d.ts +23 -32
- package/dist/src/compiled/.vendor-stamp.json +4 -4
- package/dist/src/compiled/@vercel/agent-runs/LICENSE +202 -0
- package/dist/src/compiled/@vercel/schedules/index.d.ts +45 -6
- package/dist/src/compiled/@vercel/schedules/index.js +2 -2
- package/dist/src/compiler/manifest.js +1 -1
- package/dist/src/compiler/normalize-agent-config.js +1 -1
- package/dist/src/compiler/normalize-connection.d.ts +1 -1
- package/dist/src/compiler/normalize-connection.js +1 -1
- package/dist/src/compiler/normalize-instructions.js +1 -1
- package/dist/src/compiler/normalize-skill.js +1 -1
- package/dist/src/compiler/resolve-workspace-subagent.js +1 -1
- package/dist/src/context/memory-tools.d.ts +9 -5
- package/dist/src/discover/sandbox.js +1 -1
- package/dist/src/dynamic/definition.d.ts +11 -5
- package/dist/src/dynamic/definition.js +1 -1
- package/dist/src/evals/mock-model.d.ts +1 -1
- package/dist/src/evals/session-manager.d.ts +0 -2
- package/dist/src/evals/session.d.ts +1 -11
- package/dist/src/evals/session.js +1 -1
- package/dist/src/eve-channel/index.js +1 -1
- package/dist/src/eve-channel/support.js +1 -1
- package/dist/src/execution/dynamic-workflow/tool.js +1 -1
- package/dist/src/execution/effective-agent-config.js +1 -1
- package/dist/src/execution/proxied-deliver-step.js +1 -1
- package/dist/src/execution/sandbox/bindings/just-bash-runtime.d.ts +1 -2
- package/dist/src/execution/sandbox/bindings/just-bash-runtime.js +1 -1
- package/dist/src/execution/sandbox/bindings/just-bash.js +1 -1
- package/dist/src/execution/session/active-turn.js +1 -1
- package/dist/src/execution/session/answer-caller.d.ts +9 -5
- package/dist/src/execution/session/answer-caller.js +1 -1
- package/dist/src/execution/session/principal.d.ts +8 -0
- package/dist/src/execution/session/principal.js +1 -1
- package/dist/src/execution/session/program.js +1 -1
- package/dist/src/execution/session/turn-step.js +1 -1
- package/dist/src/execution/session/turn.js +1 -1
- package/dist/src/execution/session-callback-request.js +1 -1
- package/dist/src/execution/tools/agent-router-workflow.js +1 -1
- package/dist/src/harness/attachment-staging.d.ts +2 -2
- package/dist/src/harness/attachment-staging.js +1 -1
- package/dist/src/instrumentation/ai-sdk-telemetry.d.ts +0 -2
- package/dist/src/instrumentation/providers.d.ts +1 -38
- package/dist/src/instrumentation/providers.js +1 -1
- package/dist/src/instrumentation/setup-context.d.ts +1 -7
- package/dist/src/internal/application/package.d.ts +1 -0
- package/dist/src/internal/application/package.js +1 -1
- package/dist/src/internal/application/stamped-package-version.js +1 -1
- package/dist/src/internal/authored-definition/core.js +1 -1
- package/dist/src/internal/authored-definition/schema-backed.js +1 -1
- package/dist/src/internal/classify-model-routing.d.ts +2 -3
- package/dist/src/internal/nitro/host/create-application-nitro.js +1 -1
- package/dist/src/internal/nitro/routes/schedule-collection-consumer.js +1 -1
- package/dist/src/internal/runtime-model.d.ts +9 -4
- package/dist/src/internal/runtime-model.js +1 -1
- package/dist/src/internal/workflow-bundle/authored-workflow-directives.js +1 -1
- package/dist/src/internal/workflow-bundle/builder-support.d.ts +1 -1
- package/dist/src/internal/workflow-bundle/builder-support.js +1 -1
- package/dist/src/internal/workflow-bundle/workflow-transformer.js +1 -1
- package/dist/src/models/auto.js +1 -1
- package/dist/src/protocol/delivery.d.ts +1 -0
- package/dist/src/protocol/reset-session.d.ts +0 -2
- package/dist/src/protocol/routes.d.ts +9 -2
- package/dist/src/protocol/routes.js +1 -1
- package/dist/src/public/channels/chat-sdk/chatSdkChannel.d.ts +1 -22
- package/dist/src/public/channels/discord/discordChannel.d.ts +3 -12
- package/dist/src/public/channels/discord/gateway/{index.d.ts → relay.d.ts} +2 -2
- package/dist/src/public/channels/discord/gateway/relay.js +1 -0
- package/dist/src/public/channels/discord/messages.d.ts +4 -4
- package/dist/src/public/channels/github/state.d.ts +0 -2
- package/dist/src/public/channels/index.d.ts +1 -2
- package/dist/src/public/channels/index.js +1 -1
- package/dist/src/public/channels/linear/index.d.ts +1 -1
- package/dist/src/public/channels/linear/index.js +1 -1
- package/dist/src/public/channels/linear/linearChannel.d.ts +0 -5
- package/dist/src/public/channels/linq/index.d.ts +1 -1
- package/dist/src/public/channels/linq/linqChannel.d.ts +7 -5
- package/dist/src/public/channels/photon/index.d.ts +1 -1
- package/dist/src/public/channels/photon/photonIMessageChannel.d.ts +15 -4
- package/dist/src/public/channels/slack/api.d.ts +1 -1
- package/dist/src/public/channels/slack/api.js +1 -1
- package/dist/src/public/channels/slack/blocks.d.ts +1 -1
- package/dist/src/public/channels/slack/blocks.js +2 -2
- package/dist/src/public/channels/slack/cards.d.ts +2 -297
- package/dist/src/public/channels/slack/cards.js +1 -1
- package/dist/src/public/channels/slack/index.d.ts +2 -2
- package/dist/src/public/channels/slack/index.js +1 -1
- package/dist/src/public/channels/slack/session-operations.d.ts +2 -2
- package/dist/src/public/channels/slack/session-operations.js +1 -1
- package/dist/src/public/channels/slack/slackChannel.d.ts +11 -72
- package/dist/src/public/channels/slack/slackChannel.js +1 -1
- package/dist/src/public/channels/teams/teamsChannel.d.ts +4 -3
- package/dist/src/public/channels/telegram/hitl.d.ts +2 -9
- package/dist/src/public/channels/telegram/index.d.ts +1 -1
- package/dist/src/public/channels/telegram/telegramChannel.d.ts +0 -2
- package/dist/src/public/channels/twilio/twilioChannel.d.ts +0 -2
- package/dist/src/public/channels/undelivered-reply.d.ts +0 -5
- package/dist/src/public/definitions/agent.d.ts +15 -7
- package/dist/src/public/definitions/agent.js +1 -1
- package/dist/src/public/definitions/channel.d.ts +7 -5
- package/dist/src/public/definitions/channel.js +1 -1
- package/dist/src/public/definitions/connections/protocol.d.ts +1 -7
- package/dist/src/public/definitions/connections/protocol.js +1 -1
- package/dist/src/public/experimental/channels/discord/gateway.d.ts +1 -0
- package/dist/src/public/experimental/channels/discord/gateway.js +1 -0
- package/dist/src/public/experimental/sandbox/just-bash.d.ts +1 -0
- package/dist/src/public/experimental/sandbox/just-bash.js +1 -0
- package/dist/src/public/experimental/workspace/index.d.ts +1 -0
- package/dist/src/public/experimental/workspace/index.js +1 -0
- package/dist/src/public/index.d.ts +2 -2
- package/dist/src/public/index.js +1 -1
- package/dist/src/public/instrumentation/otel.d.ts +1 -1
- package/dist/src/public/instrumentation/provider.d.ts +1 -1
- package/dist/src/public/instrumentation/provider.js +1 -1
- package/dist/src/public/memory/file/backend.d.ts +1 -1
- package/dist/src/public/memory/file/backends/in-memory.js +1 -1
- package/dist/src/public/memory/file/backends/vercel-blob.js +1 -1
- package/dist/src/public/memory/file/provider.js +1 -1
- package/dist/src/public/memory/index.d.ts +3 -11
- package/dist/src/public/models/anthropic/index.d.ts +1 -1
- package/dist/src/public/models/index.d.ts +1 -0
- package/dist/src/public/models/openai/index.d.ts +2 -2
- package/dist/src/public/next/index.d.ts +2 -2
- package/dist/src/public/sandbox/just-bash-sandbox.d.ts +27 -20
- package/dist/src/public/sandbox/just-bash.d.ts +0 -1
- package/dist/src/public/schedules/providers/vercel.d.ts +2 -0
- package/dist/src/public/schedules/providers/vercel.js +1 -1
- package/dist/src/public/sessions/index.d.ts +1 -0
- package/dist/src/public/sessions/index.js +1 -1
- package/dist/src/public/tools/index.d.ts +1 -1
- package/dist/src/public/tools/index.js +1 -1
- package/dist/src/public/workflow/api.d.ts +25 -0
- package/dist/src/public/workflow/api.js +1 -0
- package/dist/src/public/workflow/index.d.ts +76 -0
- package/dist/src/public/workflow/index.js +1 -0
- package/dist/src/public/workflow-modules.d.ts +2 -17
- package/dist/src/react/use-eve-agent.d.ts +3 -2
- package/dist/src/react/use-eve-agent.js +1 -1
- package/dist/src/reactions/kinds/model.js +1 -1
- package/dist/src/runtime/agent/resolve-model.js +1 -1
- package/dist/src/runtime/resolve-agent.js +1 -1
- package/dist/src/runtime/resolve-dynamic.js +1 -1
- package/dist/src/runtime/subagents/dynamic-agent-config.js +1 -1
- package/dist/src/runtime/subagents/workflow.js +1 -1
- package/dist/src/sandbox/providers/default.js +1 -1
- package/dist/src/self-modification/extension/subagents/agent/agent.d.ts +2 -2
- package/dist/src/self-modification/sandbox.js +1 -1
- package/dist/src/setup/integrations/discord/daemon.js +2 -2
- package/dist/src/setup/scaffold/create/project.js +2 -2
- package/dist/src/setup/scaffold/create/web-template.d.ts +2 -2
- package/dist/src/setup/scaffold/create/web-template.js +2 -2
- package/dist/src/setup/verified-remote-agent.d.ts +1 -3
- package/dist/src/shared/agent-definition.d.ts +18 -9
- package/dist/src/shared/eve-error.d.ts +22 -0
- package/dist/src/shared/eve-error.js +1 -0
- package/dist/src/shared/session.d.ts +2 -2
- package/dist/src/shared/token-usage.d.ts +7 -1
- package/dist/src/svelte/index.js +1 -1
- package/dist/src/svelte/use-eve-agent.d.ts +2 -1
- package/dist/src/svelte/use-eve-agent.js +1 -1
- package/dist/src/tools/definition.d.ts +7 -5
- package/dist/src/tools/definition.js +1 -1
- package/dist/src/tools/provided/ask-question-workflow.js +1 -1
- package/dist/src/tools/provided/sleep-workflow.js +1 -1
- package/dist/src/tracing/eve/batch-span-processor.d.ts +1 -1
- package/dist/src/tracing/eve/content-span-processor.d.ts +1 -19
- package/dist/src/tracing/eve/otel-configuration.d.ts +6 -0
- package/dist/src/tracing/eve/otel-declaration.d.ts +6 -19
- package/dist/src/tracing/eve/span-export-policy.d.ts +0 -2
- package/dist/src/tracing/local/instrumentation-runtime.d.ts +0 -3
- package/dist/src/tracing/local/traces.d.ts +0 -13
- package/dist/src/vue/index.js +1 -1
- package/dist/src/vue/use-eve-agent.d.ts +3 -2
- package/dist/src/vue/use-eve-agent.js +1 -1
- package/docs/agent-config.md +15 -11
- package/docs/channels/custom.mdx +26 -10
- package/docs/channels/discord.mdx +10 -10
- package/docs/channels/eve.mdx +15 -13
- package/docs/channels/linear.mdx +11 -0
- package/docs/channels/linq.mdx +5 -1
- package/docs/channels/photon.mdx +6 -1
- package/docs/channels/slack.mdx +73 -14
- package/docs/channels/telegram.mdx +6 -0
- package/docs/code-extension.mdx +25 -0
- package/docs/concepts/default-harness.md +2 -2
- package/docs/concepts/execution-model-and-durability.mdx +11 -11
- package/docs/concepts/project-structure.mdx +1 -1
- package/docs/concepts/security-model.md +6 -2
- package/docs/concepts/sessions-runs-and-streaming.md +23 -10
- package/docs/concepts/upgrade-to-v27-events.md +70 -1
- package/docs/connections/overview.mdx +4 -0
- package/docs/evals/reporters.mdx +21 -0
- package/docs/extensions.md +12 -0
- package/docs/getting-started.mdx +6 -0
- package/docs/guides/auth-and-route-protection.md +2 -1
- package/docs/guides/client/continuations.mdx +12 -10
- package/docs/guides/client/messages.mdx +24 -1
- package/docs/guides/client/overview.mdx +8 -6
- package/docs/guides/client/streaming.mdx +25 -7
- package/docs/guides/decide.md +3 -3
- package/docs/guides/deployment/self-hosting.md +1 -1
- package/docs/guides/deployment/vercel.mdx +1 -1
- package/docs/guides/dev-tui.md +2 -2
- package/docs/guides/frontend/meta.json +1 -0
- package/docs/guides/frontend/nextjs.mdx +329 -121
- package/docs/guides/frontend/overview.mdx +115 -335
- package/docs/guides/frontend/tanstack.mdx +1 -1
- package/docs/guides/frontend/use-eve-agent-svelte.mdx +18 -16
- package/docs/guides/frontend/use-eve-agent-vue.mdx +18 -16
- package/docs/guides/frontend/use-eve-agent.mdx +385 -0
- package/docs/guides/hooks.md +1 -1
- package/docs/guides/instrumentation/otel.mdx +3 -1
- package/docs/guides/prepare-for-1-0.md +255 -0
- package/docs/guides/remote-agents.md +26 -22
- package/docs/guides/self-modification.md +6 -0
- package/docs/instructions.mdx +1 -1
- package/docs/memory/custom-provider.md +1 -1
- package/docs/memory/file.md +11 -2
- package/docs/meta.json +1 -0
- package/docs/reference/agent-files.md +17 -17
- package/docs/reference/cli.md +15 -11
- package/docs/reference/typescript-api.md +46 -20
- package/docs/sandbox/custom-providers.mdx +2 -0
- package/docs/sandbox/default.mdx +6 -6
- package/docs/sandbox/index.mdx +6 -6
- package/docs/sandbox/just-bash.mdx +30 -21
- package/docs/subagents/index.mdx +4 -4
- package/docs/tools/human-in-the-loop.md +1 -1
- package/docs/tools/workflows.mdx +52 -8
- package/docs/tutorial/first-agent.mdx +1 -1
- package/package.json +46 -27
- package/dist/src/public/channels/discord/gateway/index.js +0 -1
- package/dist/src/self-modification/agent.d.ts +0 -12
- package/dist/src/self-modification/agent.js +0 -1
|
@@ -0,0 +1,255 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: "Prepare for 1.0"
|
|
3
|
+
description: "Update session controls, authoring definitions, imports, public types, client errors, retry options, and terminal flags for the pre-1.0 API cleanup."
|
|
4
|
+
url: /guides/prepare-for-1-0
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
Use this checklist when upgrading an existing project to the coordinated pre-1.0 API cleanup release. These changes do not make the release 1.0; the [stability policy](../reference/typescript-api#stability-policy) still distinguishes stable and experimental APIs.
|
|
8
|
+
|
|
9
|
+
Upgrade eve in your agent server and apply the authored-file changes below so it builds. Deploy it before upgrading clients: new clients call the `/end` endpoint, which older servers do not serve. Then update frontend code and scripts.
|
|
10
|
+
|
|
11
|
+
## End a session or start a new conversation
|
|
12
|
+
|
|
13
|
+
Replace retirement methods named `reset()` with `end()` on client sessions, `SessionStore`, React/Vue/Svelte bindings, channel session handles, `ChannelSource` from `eve/channels`, and the Slack handler context (`ctx.end()`):
|
|
14
|
+
|
|
15
|
+
```diff
|
|
16
|
+
-await session.reset({ reason: "Conversation finished" });
|
|
17
|
+
+await session.end({ reason: "Conversation finished" });
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
`end()` resolves with a delivery receipt, like the other session controls. The stream still records the control as `source: { control: "reset" }` on `delivery.admitted` for compatibility with recorded history, so code that matches that value does not change.
|
|
21
|
+
|
|
22
|
+
The HTTP endpoint changes from `POST /eve/v1/session/:sessionId/reset` to `POST /eve/v1/session/:sessionId/end`. Upgraded servers still serve `POST …/reset` beside `/end`, so existing HTTP callers keep working, but move them to `/end`.
|
|
23
|
+
|
|
24
|
+
Ending permanently retires the session and leaves the handle on the retired ID. Do not use `end()` for a **New chat** button. Use `newSession()` when the frontend binding or store owns session creation. When you supply an external `session`, `newSession()` only clears local state and keeps that handle; create a new client session and bind a new store or component to it instead:
|
|
25
|
+
|
|
26
|
+
```ts
|
|
27
|
+
import { Client } from "eve/client";
|
|
28
|
+
|
|
29
|
+
const client = new Client({ baseUrl: "https://agent.example" });
|
|
30
|
+
const { session } = await client.sessions.create();
|
|
31
|
+
await session.send("Start a new conversation.");
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
Use `clear()` to clear model context in the same active session instead. See [Session controls](./client/overview#sessions) for the differences.
|
|
35
|
+
|
|
36
|
+
The remote-agent cleanup path and persisted session-history encodings remain compatible with older deployments. This does not let a new client call `/end` on an old server; upgrade the server first.
|
|
37
|
+
|
|
38
|
+
## Rename the compaction threshold
|
|
39
|
+
|
|
40
|
+
`compaction.threshold` is a fraction from `0` through `1`, not a percentage. Rename the authored field without changing its value:
|
|
41
|
+
|
|
42
|
+
```diff
|
|
43
|
+
export default defineAgent({
|
|
44
|
+
- compaction: { thresholdPercent: 0.7 },
|
|
45
|
+
+ compaction: { threshold: 0.7 },
|
|
46
|
+
});
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
The old field fails validation with migration guidance. The default remains `0.9`. See [Compaction](../agent-config#compaction).
|
|
50
|
+
|
|
51
|
+
`limits.sessionUsage: false` is now accepted when you want to disable the token-usage limit, including an inherited limit. Omitting it keeps the normal default; no migration is required.
|
|
52
|
+
|
|
53
|
+
## Export defineAgent from agent.ts
|
|
54
|
+
|
|
55
|
+
Every local `agent.ts`, root or subagent, must export the value `defineAgent` returns. A plain object now fails the build with `Export defineAgent({...}) from "<path>".`:
|
|
56
|
+
|
|
57
|
+
```diff
|
|
58
|
+
-export default { model: "anthropic/claude-sonnet-5" };
|
|
59
|
+
+import { defineAgent } from "eve";
|
|
60
|
+
+
|
|
61
|
+
+export default defineAgent({ model: "anthropic/claude-sonnet-5" });
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
A dynamic subagent resolver that selects a local agent must also return `defineAgent({...})`, `defineRemoteAgent(...)`, or `null`.
|
|
65
|
+
|
|
66
|
+
`DynamicSentinel`, `DisabledToolSentinel`, and `DisabledRouteSentinel` are opaque and no longer expose `kind` or `evaluate`. Create them only with `defineDynamic()`, `disableTool()`, and `disableRoute()`; hand-written objects of the same shape are rejected.
|
|
67
|
+
|
|
68
|
+
## Wrap connection definitions
|
|
69
|
+
|
|
70
|
+
Every connection must use the helper for its protocol. A plain object is no longer assumed to be an MCP connection:
|
|
71
|
+
|
|
72
|
+
```diff
|
|
73
|
+
-export default { url: "https://issues.example/mcp" };
|
|
74
|
+
+import { defineMcpClientConnection } from "eve/connections";
|
|
75
|
+
+
|
|
76
|
+
+export default defineMcpClientConnection({ url: "https://issues.example/mcp" });
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
Use `defineOpenAPIConnection` for OpenAPI connections. Keep the helper inside the dynamic factory when authoring a dynamic connection. See [Connections](../connections).
|
|
80
|
+
|
|
81
|
+
## Choose one sandbox layout
|
|
82
|
+
|
|
83
|
+
If both `agent/sandbox.ts` and `agent/sandbox/` exist, move the definition to `agent/sandbox/sandbox.ts`. The combination now fails discovery instead of silently ignoring the root definition.
|
|
84
|
+
|
|
85
|
+
A standalone `agent/sandbox.ts` remains supported. See [Sandbox layout](../sandbox#define-an-environment).
|
|
86
|
+
|
|
87
|
+
## Move experimental imports
|
|
88
|
+
|
|
89
|
+
Import workspace helpers from the experimental entry:
|
|
90
|
+
|
|
91
|
+
```diff
|
|
92
|
+
-import { defineWorkspaceAgent } from "eve";
|
|
93
|
+
+import { defineWorkspaceAgent } from "eve/experimental/workspace";
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
Move `WorkspaceAgentDefinition` and `WorkspaceAgentTransport` type imports to the same entry. The `agents/<name>/` workspace layout and `withEve` from `eve/vercel` stay stable; the helper's experimental status does not change them.
|
|
97
|
+
|
|
98
|
+
Move just-bash `customCommands` and `filesystem` under `experimental`, and import their types, such as `JustBashCommand` and `JustBashFilesystem`, from `eve/experimental/sandbox/just-bash`. `JustBashSandbox` itself, `autoInstall`, and `prepare` stay on `eve/sandbox/just-bash`:
|
|
99
|
+
|
|
100
|
+
```diff
|
|
101
|
+
export const environment = JustBashSandbox.environment({
|
|
102
|
+
- customCommands: [today],
|
|
103
|
+
+ experimental: { customCommands: [today] },
|
|
104
|
+
});
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
The Discord Gateway relay moves and drops its prefix:
|
|
108
|
+
|
|
109
|
+
```diff
|
|
110
|
+
-import { experimental_runDiscordGatewayRelay } from "eve/channels/discord/gateway";
|
|
111
|
+
+import { runDiscordGatewayRelay } from "eve/experimental/channels/discord/gateway";
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
See [just-bash](../sandbox/just-bash) and [Discord](../channels/discord).
|
|
115
|
+
|
|
116
|
+
## Flatten reconnect options
|
|
117
|
+
|
|
118
|
+
Replace `streamReconnectPolicy` with `reconnect`, move open-retry fields directly into that object, and rename `retryableErrorStatuses`:
|
|
119
|
+
|
|
120
|
+
```diff
|
|
121
|
+
const delivery = await session.send("Continue the review.", {
|
|
122
|
+
- streamReconnectPolicy: {
|
|
123
|
+
- streamOpenReconnectPolicy: { maxAttempts: 3, baseDelayMs: 250, maxDelayMs: 5000 },
|
|
124
|
+
- retryableErrorStatuses: [429, 503],
|
|
125
|
+
+ reconnect: {
|
|
126
|
+
+ maxAttempts: 3,
|
|
127
|
+
+ baseDelayMs: 250,
|
|
128
|
+
+ maxDelayMs: 5000,
|
|
129
|
+
+ retryableStatuses: [429, 503],
|
|
130
|
+
},
|
|
131
|
+
});
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
To disable automatic reconnects:
|
|
135
|
+
|
|
136
|
+
```diff
|
|
137
|
+
-streamReconnectPolicy: { reconnect: false }
|
|
138
|
+
+reconnect: false
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
Use the exported `ReconnectOptions` type from `eve/client` instead of `StreamReconnectPolicy` or `StreamReconnectRetryPolicy`. The option also applies to client session and event readers. Defaults and cursor recovery are unchanged; following reads keep reconnecting, and server-side readers do not reconnect. See [Streaming](./client/streaming#reconnection).
|
|
142
|
+
|
|
143
|
+
## Update client error handling and saved state
|
|
144
|
+
|
|
145
|
+
Every error `eve/client` throws now extends `EveError` and carries a stable snake_case `code`. Import the error classes from `eve/client` and narrow with their static `is()` rather than `instanceof`, so errors from a separately bundled copy of eve still match:
|
|
146
|
+
|
|
147
|
+
```diff
|
|
148
|
+
-if (error instanceof SessionNotActiveError && error.code === "EVE_SESSION_NOT_ACTIVE") {
|
|
149
|
+
+if (SessionNotActiveError.is(error) && error.code === "session_not_active") {
|
|
150
|
+
// Start a new session.
|
|
151
|
+
}
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
`SessionNotActiveError.code` is `session_not_ready` (with `retryable: true`) while a session is still starting, otherwise `session_not_active`; `EVE_SESSION_NOT_ACTIVE` is gone. `ClientError.code` is now `http_error` instead of `undefined` when the response carried no code.
|
|
155
|
+
|
|
156
|
+
`session.snapshot()` now returns the full `ClientSessionState`, including the opaque `inbox` value, instead of only `sessionId` and `streamIndex`. Persist it as is and pass it back unchanged, for example with `client.sessions.attach(saved.sessionId, saved)`. See [Faster sends with `inbox`](./client/overview#faster-sends-with-inbox).
|
|
157
|
+
|
|
158
|
+
## Update Workflow imports
|
|
159
|
+
|
|
160
|
+
Import durable primitives from `eve/workflow`, and run/hook operations from `eve/workflow/api`:
|
|
161
|
+
|
|
162
|
+
```diff
|
|
163
|
+
-import { createHook, createWebhook, sleep, FatalError, RetryableError, getWorkflowMetadata } from "workflow";
|
|
164
|
+
-import { start, getRun, resumeHook } from "workflow/api";
|
|
165
|
+
+import { createHook, createWebhook, sleep, FatalError, RetryableError, getWorkflowMetadata } from "eve/workflow";
|
|
166
|
+
+import { start, getRun, resumeHook } from "eve/workflow/api";
|
|
167
|
+
```
|
|
168
|
+
|
|
169
|
+
Bare `workflow` and `workflow/*` imports in authored modules now fail the build. Only the exports listed above are public; other SDK subpaths, helpers, and options are not supported by these entries. The previously removed `agent` and `ask` helpers stay removed: importing them from `eve/workflow` fails with a pointer to `defineWorkflowTool()` from `eve/tools`.
|
|
170
|
+
|
|
171
|
+
Both entries declare eve-owned types instead of the SDK's:
|
|
172
|
+
|
|
173
|
+
- `getHookByToken` is removed. Pass a deterministic `token` to `createHook({ token })`, and resume the hook with `resumeHook(token, payload)`. `resumeHook` accepts only a token, not a hook record or an encryption-key override, and resolves to `void`.
|
|
174
|
+
- `start(workflow, args?)` takes a `"use workflow"` function, not a source string, and no options such as `deploymentId` or `world`; eve routes runs to the agent's own queue and deployment.
|
|
175
|
+
- `start` and `getRun` return a `WorkflowRun` with only `runId`, `status`, `returnValue`, and `cancel()`.
|
|
176
|
+
|
|
177
|
+
```diff
|
|
178
|
+
-const hook = await getHookByToken(token);
|
|
179
|
+
-await resumeHook(hook, payload);
|
|
180
|
+
+await resumeHook(token, payload);
|
|
181
|
+
```
|
|
182
|
+
|
|
183
|
+
Use `WorkflowHook`, `WorkflowWebhook`, and `WorkflowMetadata` from `eve/workflow`, and `WorkflowRun` and `WorkflowRunStatus` from `eve/workflow/api`, for explicit annotations. Call `eve/workflow/api` operations from routes or `"use step"` helpers, not replayed workflow bodies. Both entries use eve's bundled SDK; do not install another SDK to make these imports resolve.
|
|
184
|
+
|
|
185
|
+
You can remove `eve/workflow-modules` from tsconfig `types` and reference directives. Existing references remain resolvable through 1.x, but the entry no longer declares bare modules. See [Workflow imports](../tools/workflows#workflow-imports).
|
|
186
|
+
|
|
187
|
+
## Replace third-party types in eve signatures
|
|
188
|
+
|
|
189
|
+
eve's authoring and configuration types no longer expose AI SDK, zod, OpenTelemetry, or channel-adapter types; only the model helpers still return AI SDK models. Any AI SDK language model or OpenTelemetry processor still type-checks wherever eve accepts one, so most projects only change annotations:
|
|
190
|
+
|
|
191
|
+
- Agent `model` fields accept `EveLanguageModel` (exported from `eve` and `eve/models`); any AI SDK language model satisfies it. `anthropic()`, `openai()`, `chatgpt()`, and `mockModel()` still return AI SDK language models, so nothing changes where you pass them to AI SDK functions.
|
|
192
|
+
- `DecisionModel` instances must declare `specificationVersion: "v4"`.
|
|
193
|
+
- `TokenUsage`, the usage record `limits.sessionUsage` callbacks receive, is now exported from `eve` for annotations.
|
|
194
|
+
- `MemoryToolDefinition` is removed. Type memory provider tools as `MemoryToolSet`, a map of `defineTool()` values (`ToolDefinition` from `eve/tools`).
|
|
195
|
+
- Import `SpanProcessor`, `SpanExporter`, and `SpanProcessorOrName` from `eve/instrumentation/otel`, `LinqWebhookVerifier` from `eve/channels/linq`, and `PhotonIMessageWebhookVerifier` and `PhotonProjectCredentials` from `eve/channels/photon`.
|
|
196
|
+
|
|
197
|
+
## Keep custom data out of channel state bookkeeping
|
|
198
|
+
|
|
199
|
+
Built-in channel state types no longer include the default handlers' bookkeeping, such as Slack `taskCards` and `threadStatus`, Chat SDK streaming fields, `pendingSignIns`, posted prompt cards, `shownPromptId`, `undeliveredReplyErrorId`, and Discord's `interactionToken`, `initialResponseSent`, and `hasMessageAnchor` (read the interaction token from the Discord handle). `TelegramHitlState` is no longer exported. Addressing, identity, and audience fields are unchanged. Keep custom handler data in your own state keys instead of reading or writing these fields.
|
|
200
|
+
|
|
201
|
+
## Remove unsupported Slack card imports
|
|
202
|
+
|
|
203
|
+
Remove these exports from `eve/channels/slack` imports:
|
|
204
|
+
|
|
205
|
+
- `Modal*`, `TextInput*`, and `ExternalSelect*` builders and their associated types.
|
|
206
|
+
- `CardJSXElement` and `CardJSXProps`.
|
|
207
|
+
- `isCardElement` and `cardChildToFallbackText`.
|
|
208
|
+
- `ChatElement`, `ContainerProps`, and the builder props types: `ButtonProps`, `CardLinkProps`, `CardProps`, `DividerProps`, `FieldProps`, `ImageProps`, `LinkButtonProps`, `SelectOptionProps`, `SelectProps`, and `TextProps`.
|
|
209
|
+
|
|
210
|
+
Card builders no longer accept JSX-style props with `children`. Call their data forms instead:
|
|
211
|
+
|
|
212
|
+
```diff
|
|
213
|
+
-Actions({ children: [Button({ id: "approve", children: "Approve" })] });
|
|
214
|
+
+Actions([Button({ id: "approve", label: "Approve" })]);
|
|
215
|
+
```
|
|
216
|
+
|
|
217
|
+
Use `CardText` for labels and `cardToFallbackText` for whole cards. Use native Slack view data for custom modals; the removed builders did not have a supported eve delivery path. Built-in human-in-the-loop modals are unchanged.
|
|
218
|
+
|
|
219
|
+
Supported message cards remain available. An existing `initialMessage: { card }` continues to work; proactive messages can now also use `{ text }`, `{ markdown }`, or `{ blocks, text? }`. Optional files upload into the root message's thread. Retrying a proactive send can repeat both the root post and its uploads. See [Slack cards](../channels/slack#cards) and [proactive sends](../channels/slack#proactive-sessions).
|
|
220
|
+
|
|
221
|
+
## Replace undocumented helper imports
|
|
222
|
+
|
|
223
|
+
| Entry | Removed export | Migration |
|
|
224
|
+
| --------------------- | --------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
|
|
225
|
+
| `eve/tools` | `isDisabledToolSentinel` | Export `disableTool()` from a tool file; let the compiler handle the sentinel. |
|
|
226
|
+
| `eve/channels` | `isDisabledRouteSentinel` | Export `disableRoute()` from a route file instead of inspecting the sentinel. |
|
|
227
|
+
| `eve/instrumentation` | `isInstrumentationDisabled` | Export `disableInstrumentation()` instead of inspecting the sentinel. |
|
|
228
|
+
| `eve/client` | `failureOf` | Use `failure(view, turnId)` from `eve/events`. |
|
|
229
|
+
| `eve/channels` | `answerFromText` | Parse your channel's input and answer through its authorized session handle; see [Custom channels](../channels/custom). |
|
|
230
|
+
| `eve/channels/linear` | `defaultOnAgentSession` | Omit the override to use the built-in callback, or provide your own `onAgentSession`. |
|
|
231
|
+
|
|
232
|
+
## Rename terminal display flags
|
|
233
|
+
|
|
234
|
+
Update scripts that call `eve dev` or `eve remote connect`:
|
|
235
|
+
|
|
236
|
+
| Old flag | New flag |
|
|
237
|
+
| ------------------- | ------------------------ |
|
|
238
|
+
| `--tools` | `--show-tools` |
|
|
239
|
+
| `--reasoning` | `--show-reasoning` |
|
|
240
|
+
| `--subagents` | `--show-subagents` |
|
|
241
|
+
| `--connection-auth` | `--show-connection-auth` |
|
|
242
|
+
|
|
243
|
+
Values are unchanged, and the old display names are not aliases. For example:
|
|
244
|
+
|
|
245
|
+
```bash
|
|
246
|
+
eve dev --show-reasoning full --show-tools auto-collapsed
|
|
247
|
+
```
|
|
248
|
+
|
|
249
|
+
Model-effort `--reasoning` on `eve init` and `eve set model` is unchanged. `--assistant-response-stats`, `--context-size`, and `--logs` are unchanged too. See the [CLI reference](../reference/cli).
|
|
250
|
+
|
|
251
|
+
## Check the resulting project
|
|
252
|
+
|
|
253
|
+
Run your project's typecheck and `eve build`, then check the workflows you use: create a conversation, send a message, end it, and start another. Restore a saved session state and send to it. Test any proactive Slack messages and durable workflow waits your project defines.
|
|
254
|
+
|
|
255
|
+
Review [run-data retention](../agent-config#run-data-retention) before depending on a completed transcript remaining readable. This cleanup does not change the retention default: outside development, the default trace policy for private and unknown-audience sessions requests deletion when the session ends. Backend support determines whether deletion occurs; the current override remains experimental.
|
|
@@ -20,15 +20,15 @@ export default defineRemoteAgent({
|
|
|
20
20
|
|
|
21
21
|
`defineRemoteAgent` accepts:
|
|
22
22
|
|
|
23
|
-
| Parameter | Type
|
|
24
|
-
| ------------------ |
|
|
25
|
-
| `url` | `string`
|
|
26
|
-
| `description` | `string`
|
|
27
|
-
| `auth` | `OutboundAuthFn`
|
|
28
|
-
| `forwardPrincipal` | `boolean`
|
|
29
|
-
| `headers` | `HeadersValue`
|
|
30
|
-
| `path` | `string`
|
|
31
|
-
| `tool` | `boolean \| "deferred"`
|
|
23
|
+
| Parameter | Type | Required | Default | Description |
|
|
24
|
+
| ------------------ | --------------------------------------------- | -------- | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
25
|
+
| `url` | `string \| (() => string \| Promise<string>)` | Yes | n/a | Base URL of the remote eve deployment. Use a function for [runtime URLs](#runtime-urls). |
|
|
26
|
+
| `description` | `string` | Yes | n/a | Model-visible delegation description. |
|
|
27
|
+
| `auth` | `OutboundAuthFn` | No | none | Outbound auth hook from `eve/agents/auth`. |
|
|
28
|
+
| `forwardPrincipal` | `boolean` | No | `false` | Forward the dispatching turn's session principal to the remote deployment (see [Forwarding the caller identity](#forwarding-the-caller-identity)). |
|
|
29
|
+
| `headers` | `HeadersValue` | No | none | Static or lazily resolved request headers. |
|
|
30
|
+
| `path` | `string` | No | `/eve/v1/session` | Route appended to `url` for the create-session request. |
|
|
31
|
+
| `tool` | `boolean \| "deferred"` | No | `true` | Expose the remote agent as a tool to the parent model. Set `false` to allow only `ctx.agent()` calls from authored workflow tools. |
|
|
32
32
|
|
|
33
33
|
## Dynamic remote agents
|
|
34
34
|
|
|
@@ -71,7 +71,7 @@ export default defineDynamic((ctx) => {
|
|
|
71
71
|
```
|
|
72
72
|
|
|
73
73
|
A child keeps the parent context and memo results used to select its remote configuration.
|
|
74
|
-
Later messages, answers, cancellation,
|
|
74
|
+
Later messages, answers, cancellation, session retirement, and stream reads use that original selection when
|
|
75
75
|
rebuilding transport credentials. Only saved memo results are available: a missing result or a
|
|
76
76
|
changed child name or URL fails before credentials are sent. `ctx.messages()` is unavailable
|
|
77
77
|
during this reconstruction, including when eve opens the child; keep conversation-based
|
|
@@ -81,20 +81,22 @@ selection inside a memo. This does not change the per-message caller identity de
|
|
|
81
81
|
|
|
82
82
|
## Runtime URLs
|
|
83
83
|
|
|
84
|
-
A
|
|
84
|
+
A string `url` is read at compile time. Use a function when an environment variable
|
|
85
|
+
supplies the URL only at runtime. eve invokes it when resolving the runtime agent graph;
|
|
86
|
+
it can return a string or a promise:
|
|
85
87
|
|
|
86
88
|
```ts title="agent/subagents/weather.ts"
|
|
87
|
-
import {
|
|
89
|
+
import { defineRemoteAgent } from "eve";
|
|
88
90
|
|
|
89
|
-
export default
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
}),
|
|
94
|
-
);
|
|
91
|
+
export default defineRemoteAgent({
|
|
92
|
+
url: () => process.env.WEATHER_AGENT_URL ?? "https://weather-agent.example.com",
|
|
93
|
+
description: "Answers weather, temperature, forecast, wind, rain, and snow questions.",
|
|
94
|
+
});
|
|
95
95
|
```
|
|
96
96
|
|
|
97
|
-
`url` must be a non-empty string.
|
|
97
|
+
The resolved `url` must be a non-empty string. Use `defineDynamic` when the current
|
|
98
|
+
session determines which agent is exposed or whether it is available.
|
|
99
|
+
`auth` and `headers` remain lazy callbacks resolved per request.
|
|
98
100
|
|
|
99
101
|
## Calling a remote agent
|
|
100
102
|
|
|
@@ -222,9 +224,11 @@ The callback URL must use `http` or `https` and reach the parent at a public add
|
|
|
222
224
|
|
|
223
225
|
Callback URLs contain only the message's callback capability, never the parent's deployment-protection bypass secret. For a parent protected by Vercel Deployment Protection, configure Trusted Sources on the parent to admit the remote project and environment.
|
|
224
226
|
|
|
225
|
-
On the remote deployment, set `EVE_CALLBACK_TRUSTED_ORIGINS` to a comma-separated list of
|
|
227
|
+
On the remote deployment, set `EVE_CALLBACK_TRUSTED_ORIGINS` to a comma-separated list of parent HTTPS origins, for example `https://parent.example.com`. Each entry is an exact origin or starts with a `*.` label, as described below. The remote attaches its own short-lived Vercel OIDC token only to those origins and its own deployment origins; an exact entry does not extend trust to other ports or subdomains. Keep the remote's Vercel OIDC token available at runtime. Callbacks do not follow redirects.
|
|
228
|
+
|
|
229
|
+
Outside production, a parent's callback URL uses its generated deployment URL, which changes with every deployment. If those deployments are served under a domain you control, trust them with a leading `*.` label, for example `https://*.preview.example.com`. The wildcard matches exactly one label (`parent-abc123.preview.example.com`, but not `preview.example.com` or `a.b.preview.example.com`), and the port still has to match. It must be followed by at least two labels, and entries with a trailing dot are rejected. eve also rejects `https://*.vercel.app`, because every Vercel deployment shares that domain, but it does not detect other shared domains such as `*.github.io`.
|
|
226
230
|
|
|
227
|
-
Adding an origin grants trust: that recipient receives a bearer credential for the remote project's identity, not a token scoped to the callback recipient. List only parents you trust to act as the remote project until the token expires. A recipient can replay the token against other services, deployment-protection rules, or federated cloud roles that accept that identity.
|
|
231
|
+
Adding an origin grants trust: that recipient receives a bearer credential for the remote project's identity, not a token scoped to the callback recipient. List only parents you trust to act as the remote project until the token expires, and use a wildcard only when you control every host under it. A recipient can replay the token against other services, deployment-protection rules, or federated cloud roles that accept that identity.
|
|
228
232
|
|
|
229
233
|
This configuration is required when upgrading a protected cross-project setup that previously relied on a bypass secret in callback URLs. If either side is not on Vercel, make the capability-protected callback route reachable through your hosting policy; the framework does not forward a deployment-wide credential to the remote service.
|
|
230
234
|
|
|
@@ -234,7 +238,7 @@ Clients follow a remote child through the parent. [`session.agent(opened).stream
|
|
|
234
238
|
|
|
235
239
|
Cancelling the parent turn or the agent task with `eve__task_cancel` also cancels the remote child's current turn. eve resolves the remote's `headers` and `auth` again for every cancellation attempt, so rotating credentials work the same way as they do for session creation. Cancellation always uses the standard eve cancel path on `url`, even when `path` customizes only the create-session endpoint. The remote child reports `turn.settled` with `outcome: "cancelled"` on its own stream; an older or unreachable remote is logged but cannot turn the parent's cancellation into a failure.
|
|
236
240
|
|
|
237
|
-
When the workflow run that opened a remote child finishes, eve sends an authenticated
|
|
241
|
+
When the workflow run that opened a remote child finishes, eve sends an authenticated request to end it. An agent task's run finishes when the parent session ends. Ending retires the parked remote session and recursively cleans up its descendants. Parent cleanup retains its earlier wire path so independently deployed parents and children can run different eve versions. The request uses freshly resolved `headers` and `auth`; failures are logged so an unreachable remote cannot block parent finalization.
|
|
238
242
|
|
|
239
243
|
The parent names its remote agent protocol version when it creates the child, and the remote
|
|
240
244
|
answers with the version it serves. This release serves protocols 2 and 3. A protocol-3 parent
|
|
@@ -45,6 +45,12 @@ export default selfModification({
|
|
|
45
45
|
|
|
46
46
|
The bare `eve/self-modification` entry is removed. Mount `eve/extensions/self-modification/local` for development or `eve/extensions/self-modification/remote` for deployed source changes. The local mount does not accept a `deployed` option. If your mount sets `deployed`, eve rejects it and asks you to move that configuration to an `eve/extensions/self-modification/remote` mount.
|
|
47
47
|
|
|
48
|
+
## Migrate a retired scaffold
|
|
49
|
+
|
|
50
|
+
The scaffold under `agent/subagents/self-modification/` is no longer supported. The disabled agent helper, including `eve/internal/self-modification/agent`, has been removed. Do not use the old `@eve/self-modification` compatibility package for new installations.
|
|
51
|
+
|
|
52
|
+
Preserve any authored changes, then remove the old scaffold directory. Run `eve add eve/self-modification` to create the supported local extension mount. Setup rejects the old directory rather than deleting it. The bundled local extension and the separate remote extension remain supported.
|
|
53
|
+
|
|
48
54
|
## Propose changes from a deployed agent
|
|
49
55
|
|
|
50
56
|
`eve/extensions/self-modification/remote` is a separate extension for deployed agents. It adds a subagent that checks out your repository in a sandbox, edits the authored source, and opens a draft pull request against a target branch. It never changes the running deployment. Changes take effect only after you review, merge, and redeploy.
|
package/docs/instructions.mdx
CHANGED
|
@@ -82,7 +82,7 @@ See [Dynamic capabilities](./guides/dynamic-capabilities) for examples and failu
|
|
|
82
82
|
|
|
83
83
|
## History controls and prompt caching
|
|
84
84
|
|
|
85
|
-
[Compaction](./concepts/sessions-runs-and-streaming#compact-clear-and-
|
|
85
|
+
[Compaction](./concepts/sessions-runs-and-streaming#compact-clear-and-end) treats user-role instructions like ordinary conversation history, so a summary may replace their original text. Clear removes them with the rest of model-message history and does not rerun static or dynamic instructions. System-role instructions remain because they are outside history.
|
|
86
86
|
|
|
87
87
|
Keep system-role content stable and place it before frequently changing context when practical. That gives providers the best opportunity to reuse a prompt prefix, but cache behavior and billing remain provider-specific. User-role instructions preserve the normal append-only message prefix. Framework announcements about available skills and parked agents are retained in user-role history: changed snapshots append after earlier steps instead of replacing the context sent with those steps. Unchanged announcements are skipped until history is cleared or compacted. eve does not promise a cache hit.
|
|
88
88
|
|
|
@@ -148,7 +148,7 @@ context. The `id` also identifies the record in
|
|
|
148
148
|
|
|
149
149
|
### Tools
|
|
150
150
|
|
|
151
|
-
`tools()` returns a map of `defineTool()` values or `null`. eve qualifies each
|
|
151
|
+
`tools()` returns a `MemoryToolSet`, a map of `defineTool()` values, or `null`. eve qualifies each
|
|
152
152
|
key as `<slot>__<key>`; the qualified name must start with a letter, contain
|
|
153
153
|
only letters, digits, underscores, or dashes, and be at most 64 characters.
|
|
154
154
|
Schemas, `approval`, `outputSchema`, and `toModelOutput` work as they do for
|
package/docs/memory/file.md
CHANGED
|
@@ -159,11 +159,13 @@ import { MemoryDocumentConflictError, type MemoryDocumentBackend } from "eve/mem
|
|
|
159
159
|
|
|
160
160
|
export function kvBackend(store: KvStore): MemoryDocumentBackend {
|
|
161
161
|
return {
|
|
162
|
-
async read({ key }) {
|
|
162
|
+
async read({ key, signal }) {
|
|
163
|
+
signal.throwIfAborted();
|
|
163
164
|
const row = await store.get(key);
|
|
164
165
|
return row ? { content: row.content, version: row.version } : null;
|
|
165
166
|
},
|
|
166
|
-
async write({ key, content, expectedVersion }) {
|
|
167
|
+
async write({ key, content, expectedVersion, signal }) {
|
|
168
|
+
signal.throwIfAborted();
|
|
167
169
|
const ok = await store.compareAndSet(key, content, expectedVersion);
|
|
168
170
|
if (!ok) throw new MemoryDocumentConflictError(key);
|
|
169
171
|
return { content, version: await store.version(key) };
|
|
@@ -176,6 +178,13 @@ export function kvBackend(store: KvStore): MemoryDocumentBackend {
|
|
|
176
178
|
`MemoryDocumentConflictError` when `expectedVersion` no longer matches. An
|
|
177
179
|
`expectedVersion` of `null` means the document must not exist yet.
|
|
178
180
|
|
|
181
|
+
Both methods receive a `signal: AbortSignal`. Check it before starting work and
|
|
182
|
+
pass it to storage operations that support cancellation. When upgrading from
|
|
183
|
+
`eve@0.84.x`, rename the backend input's `abortSignal` property to `signal`.
|
|
184
|
+
Backends written for `0.83.x` or earlier already use `signal` and need no change.
|
|
185
|
+
Memory and tool execution contexts still expose `ctx.abortSignal`; pass that
|
|
186
|
+
value as the backend's `signal`.
|
|
187
|
+
|
|
179
188
|
A backend changes only where the document is stored. It does not change file
|
|
180
189
|
memory's recall format or tools. When you need different retrieval, capture, or
|
|
181
190
|
tools, [build a memory provider](./custom-provider) instead.
|
package/docs/meta.json
CHANGED
|
@@ -46,23 +46,23 @@ A standalone root agent uses its package name (without an npm scope), or its app
|
|
|
46
46
|
|
|
47
47
|
Paths below are relative to the agent directory. Root agents can use every path; subagents can use paths marked **Yes**.
|
|
48
48
|
|
|
49
|
-
| Path | Purpose | Available to subagents | Notes
|
|
50
|
-
| ------------------------------------------------------- | ----------------------------------------- | ---------------------- |
|
|
51
|
-
| `agent.ts` | Runtime config | Yes | Model, model options, compaction, build, and experimental settings. See [Agents](/docs/agent-config).
|
|
52
|
-
| `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).
|
|
53
|
-
| `instrumentation/` | Telemetry providers and destinations | No | One path-named provider per file. See [Instrumentation](/docs/observability/instrumentation).
|
|
54
|
-
| `channels/` | HTTP and messaging entry points | No | See [Channels](/docs/channels/overview).
|
|
55
|
-
| `connections/` | External MCP and OpenAPI services | Yes | Static files define path-named connections; dynamic sources can resolve caller-specific connections.
|
|
56
|
-
| `extensions/` | Mounted reusable capabilities | Yes | File or directory mounts. See [Extensions](/docs/extensions).
|
|
57
|
-
| `hooks/` | Lifecycle and stream-event subscribers | Yes | Module-backed only; recursive directories are supported.
|
|
58
|
-
| `skills/` | On-demand procedures and capability packs | Yes | Flat Markdown, module-backed skills, or packaged skills.
|
|
59
|
-
| `lib/` | Shared authored helper code | Yes | Import-only; not copied into the sandbox. Helpers can import data files such as JSON from here.
|
|
60
|
-
| `memory.ts` or `memory/<name>.ts` | Cross-session memory | Yes | Provider-backed slots. See [Memory](/docs/memory).
|
|
61
|
-
| `sandbox.ts` or `sandbox/sandbox.ts` | The agent's sandbox | Yes | The framework default applies when neither is authored. When `sandbox/` exists,
|
|
62
|
-
| `sandbox/workspace/**` | Files seeded into the sandbox | Yes | Copied into the prepared environment; each new session sandbox starts with them in the workspace root.
|
|
63
|
-
| `tools/` | Typed executable integrations | Yes | Module-backed only.
|
|
64
|
-
| `schedules/` | Recurring jobs | No | `defineSchedule` modules or Markdown prompts with `cron` frontmatter; recursive nesting is supported.
|
|
65
|
-
| `subagents/` | Specialist child agents | Yes | Local directories or remote-agent definitions; nested subagents are supported.
|
|
49
|
+
| Path | Purpose | Available to subagents | Notes |
|
|
50
|
+
| ------------------------------------------------------- | ----------------------------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
51
|
+
| `agent.ts` | Runtime config | Yes | Model, model options, compaction, build, and experimental settings. See [Agents](/docs/agent-config). |
|
|
52
|
+
| `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). |
|
|
53
|
+
| `instrumentation/` | Telemetry providers and destinations | No | One path-named provider per file. See [Instrumentation](/docs/observability/instrumentation). |
|
|
54
|
+
| `channels/` | HTTP and messaging entry points | No | See [Channels](/docs/channels/overview). |
|
|
55
|
+
| `connections/` | External MCP and OpenAPI services | Yes | Static files define path-named connections; dynamic sources can resolve caller-specific connections. |
|
|
56
|
+
| `extensions/` | Mounted reusable capabilities | Yes | File or directory mounts. See [Extensions](/docs/extensions). |
|
|
57
|
+
| `hooks/` | Lifecycle and stream-event subscribers | Yes | Module-backed only; recursive directories are supported. |
|
|
58
|
+
| `skills/` | On-demand procedures and capability packs | Yes | Flat Markdown, module-backed skills, or packaged skills. |
|
|
59
|
+
| `lib/` | Shared authored helper code | Yes | Import-only; not copied into the sandbox. Helpers can import data files such as JSON from here. |
|
|
60
|
+
| `memory.ts` or `memory/<name>.ts` | Cross-session memory | Yes | Provider-backed slots. See [Memory](/docs/memory). |
|
|
61
|
+
| `sandbox.ts` or `sandbox/sandbox.ts` | The agent's sandbox | Yes | The framework default applies when neither is authored. When `sandbox/` exists, use `sandbox/sandbox.ts`; a root `sandbox.ts` beside that folder is an error. |
|
|
62
|
+
| `sandbox/workspace/**` | Files seeded into the sandbox | Yes | Copied into the prepared environment; each new session sandbox starts with them in the workspace root. |
|
|
63
|
+
| `tools/` | Typed executable integrations | Yes | Module-backed only. |
|
|
64
|
+
| `schedules/` | Recurring jobs | No | `defineSchedule` modules or Markdown prompts with `cron` frontmatter; recursive nesting is supported. |
|
|
65
|
+
| `subagents/` | Specialist child agents | Yes | Local directories or remote-agent definitions; nested subagents are supported. |
|
|
66
66
|
|
|
67
67
|
## Colocated tests
|
|
68
68
|
|
package/docs/reference/cli.md
CHANGED
|
@@ -34,7 +34,7 @@ eve collects CLI telemetry by default to improve the command-line interface. Run
|
|
|
34
34
|
## `eve init`
|
|
35
35
|
|
|
36
36
|
```bash
|
|
37
|
-
eve init [target] [--model <provider/model-id>] [--reasoning <effort>] [--
|
|
37
|
+
eve init [target] [--model <provider/model-id>] [--reasoning <effort>] [--non-interactive]
|
|
38
38
|
```
|
|
39
39
|
|
|
40
40
|
Creates a new agent app or adds an agent to an existing app. Always installs dependencies. New directories also initialize Git.
|
|
@@ -51,12 +51,13 @@ Existing packages do not need a target-selection prompt: run `eve init` from the
|
|
|
51
51
|
|
|
52
52
|
After scaffolding in an interactive human terminal, eve opens the TUI directly. Pass `-n` or `--non-interactive` to return after scaffolding instead. It still installs dependencies and follows the normal Git setup behavior. Noninteractive and coding-agent invocations return without starting an interactive session. Fresh projects use the parent workspace's package manager when there is one; otherwise they use the manager that launched `eve init`.
|
|
53
53
|
|
|
54
|
-
| Flag | Type | Default | Description
|
|
55
|
-
| ----------------------- | ------ | ---------------------------------------------------- |
|
|
56
|
-
| `--model <model>` | string | `openai/gpt-6-luna-fast` | Set the root agent's AI Gateway model ID.
|
|
57
|
-
| `--reasoning <effort>` | enum | `high` without `--model`; otherwise provider default | Set reasoning to `none`, `minimal`, `low`, `medium`, `high`, or `xhigh`. `provider-default` leaves the field unauthored.
|
|
58
|
-
| `--
|
|
59
|
-
| `-
|
|
54
|
+
| Flag | Type | Default | Description |
|
|
55
|
+
| ----------------------- | ------ | ---------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
|
|
56
|
+
| `--model <model>` | string | `openai/gpt-6-luna-fast` | Set the root agent's AI Gateway model ID. |
|
|
57
|
+
| `--reasoning <effort>` | enum | `high` without `--model`; otherwise provider default | Set reasoning to `none`, `minimal`, `low`, `medium`, `high`, or `xhigh`. `provider-default` leaves the field unauthored. |
|
|
58
|
+
| `--agents <names>` | string | unset | Create a new workspace with comma-separated agent names, such as `support,research`, or add members to an existing workspace. |
|
|
59
|
+
| `-y, --yes` | flag | off | Accepted for compatibility; warns and has no effect. |
|
|
60
|
+
| `-n, --non-interactive` | flag | off | Scaffold and install dependencies without starting development. |
|
|
60
61
|
|
|
61
62
|
## `eve extension`
|
|
62
63
|
|
|
@@ -77,6 +78,7 @@ Creates a new extension package, installs dependencies, and initializes Git. Pri
|
|
|
77
78
|
| No target | Same as `.` for humans; coding agents get a short setup guide |
|
|
78
79
|
|
|
79
80
|
Create-only: cannot target an existing project that already has a `package.json`.
|
|
81
|
+
`-y` and `--yes` are accepted for compatibility; they warn and have no effect.
|
|
80
82
|
|
|
81
83
|
See [Extensions](/docs/extensions) for authoring and mount details.
|
|
82
84
|
|
|
@@ -279,10 +281,10 @@ Starts a local development server and terminal UI. To connect the UI to an exist
|
|
|
279
281
|
| `--no-default-extensions` | flag | extensions on | Do not mount bundled development extensions |
|
|
280
282
|
| `--name <name>` | string | app folder name | Title shown in the terminal UI |
|
|
281
283
|
| `--input <text>` | string | none | Pre-fill the prompt input |
|
|
282
|
-
| `--tools <mode>`
|
|
283
|
-
| `--reasoning <mode>`
|
|
284
|
-
| `--subagents <mode>`
|
|
285
|
-
| `--connection-auth <mode>`
|
|
284
|
+
| `--show-tools <mode>` | enum | `auto-collapsed` | Tool-call rendering |
|
|
285
|
+
| `--show-reasoning <mode>` | enum | `auto-collapsed` | Reasoning rendering |
|
|
286
|
+
| `--show-subagents <mode>` | enum | `collapsed` | Subagent task rendering: `full`, `collapsed`, or `hidden` |
|
|
287
|
+
| `--show-connection-auth <mode>` | enum | `full` | Connection-authorization rendering |
|
|
286
288
|
| `--assistant-response-stats <mode>` | enum | `tokensPerSecond` | Assistant header statistic |
|
|
287
289
|
| `--context-size <tokens>` | number | none | Model context window size |
|
|
288
290
|
| `--logs <mode>` | enum | `error` | Display `none`, `error`, `warn`, `debug`, or `all` logs |
|
|
@@ -342,6 +344,8 @@ eve remote connect --url <url> --print <prompt> [-H "Name: value"]
|
|
|
342
344
|
|
|
343
345
|
Without `--print`, `connect` requires a terminal and opens the interactive UI. Pass `--print` and a prompt to send one message without a terminal UI. eve writes only the final assistant text to stdout, then exits. It writes errors to stderr and exits nonzero if the turn fails, is cancelled, needs input or authorization, or the stream ends before the turn settles. The error includes the session ID when the server has accepted the message. `--print` starts a new conversation each time and does not answer pending requests; to answer that session's pending request or script multi-turn sessions, use the `eve/client` API. `--input` only pre-fills the interactive UI and cannot be used with `--print`.
|
|
344
346
|
|
|
347
|
+
Interactive `connect` accepts the same display flags as [`eve dev`](#eve-dev): `--show-tools`, `--show-reasoning`, `--show-subagents`, `--show-connection-auth`, `--assistant-response-stats`, `--context-size`, and `--logs`. The `--show-*` flags control rendering, not model reasoning effort. Set effort with `eve set model --reasoning <effort>` or `eve init --reasoning <effort>`.
|
|
348
|
+
|
|
345
349
|
Use `-H, --header <header>` for a bearer token or another custom request header; repeat it for multiple headers. For HTTP Basic authentication, put credentials in the URL. eve sends them as a Basic `Authorization` header and removes them from the target URL.
|
|
346
350
|
|
|
347
351
|
### `eve remote info`
|