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.
Files changed (290) hide show
  1. package/CHANGELOG.md +34 -3073
  2. package/README.md +7 -4
  3. package/dist/src/acp/adapter.d.ts +2 -26
  4. package/dist/src/acp/adapter.js +1 -1
  5. package/dist/src/acp/server.d.ts +0 -3
  6. package/dist/src/ai/decision-adapter.d.ts +5 -3
  7. package/dist/src/ai/decision-adapter.js +1 -1
  8. package/dist/src/ai/decision-types.d.ts +4 -3
  9. package/dist/src/channel/adapter.d.ts +0 -14
  10. package/dist/src/channel/auth/definitions.d.ts +0 -4
  11. package/dist/src/channel/channel-address.d.ts +1 -1
  12. package/dist/src/channel/channel-address.js +1 -1
  13. package/dist/src/channel/channel-operations.d.ts +2 -2
  14. package/dist/src/channel/channel-operations.js +1 -1
  15. package/dist/src/channel/prompt-queue.d.ts +0 -2
  16. package/dist/src/channel/session-not-active-error.d.ts +10 -5
  17. package/dist/src/channel/session-not-active-error.js +1 -1
  18. package/dist/src/channel/session-stranded-error.d.ts +1 -1
  19. package/dist/src/channel/session.d.ts +3 -4
  20. package/dist/src/channel/session.js +1 -1
  21. package/dist/src/channel/types.d.ts +5 -14
  22. package/dist/src/chunks/{use-eve-agent-B2jCfcnG.js → use-eve-agent-BExXjBv6.js} +82 -72
  23. package/dist/src/chunks/{use-eve-agent-DCLFi26P.js → use-eve-agent-C0KHCyb9.js} +82 -72
  24. package/dist/src/cli/commands/agent-prompt/collect-intent.md +2 -1
  25. package/dist/src/cli/commands/agent-prompt/scaffold.md +1 -2
  26. package/dist/src/cli/dev/command-options.d.ts +4 -4
  27. package/dist/src/cli/dev/command.js +1 -1
  28. package/dist/src/cli/dev/tui/runner.d.ts +1 -1
  29. package/dist/src/cli/dev/tui/runner.js +2 -2
  30. package/dist/src/cli/dev/tui/test/fake-eve-server.js +1 -1
  31. package/dist/src/cli/dev/tui/tool-format.d.ts +2 -2
  32. package/dist/src/cli/dev/ui-options.d.ts +4 -4
  33. package/dist/src/cli/dev/ui-options.js +1 -1
  34. package/dist/src/cli/run.js +1 -1
  35. package/dist/src/client/agent-info-error.d.ts +4 -1
  36. package/dist/src/client/agent-info-error.js +1 -1
  37. package/dist/src/client/agent-session.d.ts +1 -4
  38. package/dist/src/client/agent-session.js +1 -1
  39. package/dist/src/client/agent-stream-follower.js +1 -1
  40. package/dist/src/client/client-error.d.ts +13 -4
  41. package/dist/src/client/client-error.js +1 -1
  42. package/dist/src/client/delivery.d.ts +2 -17
  43. package/dist/src/client/health-response-error.d.ts +4 -1
  44. package/dist/src/client/health-response-error.js +1 -1
  45. package/dist/src/client/index.d.ts +5 -3
  46. package/dist/src/client/index.js +1 -1
  47. package/dist/src/client/open-stream.d.ts +7 -12
  48. package/dist/src/client/open-stream.js +1 -1
  49. package/dist/src/client/session-controls.d.ts +2 -2
  50. package/dist/src/client/session-controls.js +1 -1
  51. package/dist/src/client/session-event-stream.d.ts +2 -2
  52. package/dist/src/client/session-event-stream.js +1 -1
  53. package/dist/src/client/session-store.d.ts +2 -6
  54. package/dist/src/client/session-store.js +1 -1
  55. package/dist/src/client/session.d.ts +4 -13
  56. package/dist/src/client/session.js +1 -1
  57. package/dist/src/client/sessions.d.ts +3 -6
  58. package/dist/src/client/types.d.ts +23 -32
  59. package/dist/src/compiled/.vendor-stamp.json +4 -4
  60. package/dist/src/compiled/@vercel/agent-runs/LICENSE +202 -0
  61. package/dist/src/compiled/@vercel/schedules/index.d.ts +45 -6
  62. package/dist/src/compiled/@vercel/schedules/index.js +2 -2
  63. package/dist/src/compiler/manifest.js +1 -1
  64. package/dist/src/compiler/normalize-agent-config.js +1 -1
  65. package/dist/src/compiler/normalize-connection.d.ts +1 -1
  66. package/dist/src/compiler/normalize-connection.js +1 -1
  67. package/dist/src/compiler/normalize-instructions.js +1 -1
  68. package/dist/src/compiler/normalize-skill.js +1 -1
  69. package/dist/src/compiler/resolve-workspace-subagent.js +1 -1
  70. package/dist/src/context/memory-tools.d.ts +9 -5
  71. package/dist/src/discover/sandbox.js +1 -1
  72. package/dist/src/dynamic/definition.d.ts +11 -5
  73. package/dist/src/dynamic/definition.js +1 -1
  74. package/dist/src/evals/mock-model.d.ts +1 -1
  75. package/dist/src/evals/session-manager.d.ts +0 -2
  76. package/dist/src/evals/session.d.ts +1 -11
  77. package/dist/src/evals/session.js +1 -1
  78. package/dist/src/eve-channel/index.js +1 -1
  79. package/dist/src/eve-channel/support.js +1 -1
  80. package/dist/src/execution/dynamic-workflow/tool.js +1 -1
  81. package/dist/src/execution/effective-agent-config.js +1 -1
  82. package/dist/src/execution/proxied-deliver-step.js +1 -1
  83. package/dist/src/execution/sandbox/bindings/just-bash-runtime.d.ts +1 -2
  84. package/dist/src/execution/sandbox/bindings/just-bash-runtime.js +1 -1
  85. package/dist/src/execution/sandbox/bindings/just-bash.js +1 -1
  86. package/dist/src/execution/session/active-turn.js +1 -1
  87. package/dist/src/execution/session/answer-caller.d.ts +9 -5
  88. package/dist/src/execution/session/answer-caller.js +1 -1
  89. package/dist/src/execution/session/principal.d.ts +8 -0
  90. package/dist/src/execution/session/principal.js +1 -1
  91. package/dist/src/execution/session/program.js +1 -1
  92. package/dist/src/execution/session/turn-step.js +1 -1
  93. package/dist/src/execution/session/turn.js +1 -1
  94. package/dist/src/execution/session-callback-request.js +1 -1
  95. package/dist/src/execution/tools/agent-router-workflow.js +1 -1
  96. package/dist/src/harness/attachment-staging.d.ts +2 -2
  97. package/dist/src/harness/attachment-staging.js +1 -1
  98. package/dist/src/instrumentation/ai-sdk-telemetry.d.ts +0 -2
  99. package/dist/src/instrumentation/providers.d.ts +1 -38
  100. package/dist/src/instrumentation/providers.js +1 -1
  101. package/dist/src/instrumentation/setup-context.d.ts +1 -7
  102. package/dist/src/internal/application/package.d.ts +1 -0
  103. package/dist/src/internal/application/package.js +1 -1
  104. package/dist/src/internal/application/stamped-package-version.js +1 -1
  105. package/dist/src/internal/authored-definition/core.js +1 -1
  106. package/dist/src/internal/authored-definition/schema-backed.js +1 -1
  107. package/dist/src/internal/classify-model-routing.d.ts +2 -3
  108. package/dist/src/internal/nitro/host/create-application-nitro.js +1 -1
  109. package/dist/src/internal/nitro/routes/schedule-collection-consumer.js +1 -1
  110. package/dist/src/internal/runtime-model.d.ts +9 -4
  111. package/dist/src/internal/runtime-model.js +1 -1
  112. package/dist/src/internal/workflow-bundle/authored-workflow-directives.js +1 -1
  113. package/dist/src/internal/workflow-bundle/builder-support.d.ts +1 -1
  114. package/dist/src/internal/workflow-bundle/builder-support.js +1 -1
  115. package/dist/src/internal/workflow-bundle/workflow-transformer.js +1 -1
  116. package/dist/src/models/auto.js +1 -1
  117. package/dist/src/protocol/delivery.d.ts +1 -0
  118. package/dist/src/protocol/reset-session.d.ts +0 -2
  119. package/dist/src/protocol/routes.d.ts +9 -2
  120. package/dist/src/protocol/routes.js +1 -1
  121. package/dist/src/public/channels/chat-sdk/chatSdkChannel.d.ts +1 -22
  122. package/dist/src/public/channels/discord/discordChannel.d.ts +3 -12
  123. package/dist/src/public/channels/discord/gateway/{index.d.ts → relay.d.ts} +2 -2
  124. package/dist/src/public/channels/discord/gateway/relay.js +1 -0
  125. package/dist/src/public/channels/discord/messages.d.ts +4 -4
  126. package/dist/src/public/channels/github/state.d.ts +0 -2
  127. package/dist/src/public/channels/index.d.ts +1 -2
  128. package/dist/src/public/channels/index.js +1 -1
  129. package/dist/src/public/channels/linear/index.d.ts +1 -1
  130. package/dist/src/public/channels/linear/index.js +1 -1
  131. package/dist/src/public/channels/linear/linearChannel.d.ts +0 -5
  132. package/dist/src/public/channels/linq/index.d.ts +1 -1
  133. package/dist/src/public/channels/linq/linqChannel.d.ts +7 -5
  134. package/dist/src/public/channels/photon/index.d.ts +1 -1
  135. package/dist/src/public/channels/photon/photonIMessageChannel.d.ts +15 -4
  136. package/dist/src/public/channels/slack/api.d.ts +1 -1
  137. package/dist/src/public/channels/slack/api.js +1 -1
  138. package/dist/src/public/channels/slack/blocks.d.ts +1 -1
  139. package/dist/src/public/channels/slack/blocks.js +2 -2
  140. package/dist/src/public/channels/slack/cards.d.ts +2 -297
  141. package/dist/src/public/channels/slack/cards.js +1 -1
  142. package/dist/src/public/channels/slack/index.d.ts +2 -2
  143. package/dist/src/public/channels/slack/index.js +1 -1
  144. package/dist/src/public/channels/slack/session-operations.d.ts +2 -2
  145. package/dist/src/public/channels/slack/session-operations.js +1 -1
  146. package/dist/src/public/channels/slack/slackChannel.d.ts +11 -72
  147. package/dist/src/public/channels/slack/slackChannel.js +1 -1
  148. package/dist/src/public/channels/teams/teamsChannel.d.ts +4 -3
  149. package/dist/src/public/channels/telegram/hitl.d.ts +2 -9
  150. package/dist/src/public/channels/telegram/index.d.ts +1 -1
  151. package/dist/src/public/channels/telegram/telegramChannel.d.ts +0 -2
  152. package/dist/src/public/channels/twilio/twilioChannel.d.ts +0 -2
  153. package/dist/src/public/channels/undelivered-reply.d.ts +0 -5
  154. package/dist/src/public/definitions/agent.d.ts +15 -7
  155. package/dist/src/public/definitions/agent.js +1 -1
  156. package/dist/src/public/definitions/channel.d.ts +7 -5
  157. package/dist/src/public/definitions/channel.js +1 -1
  158. package/dist/src/public/definitions/connections/protocol.d.ts +1 -7
  159. package/dist/src/public/definitions/connections/protocol.js +1 -1
  160. package/dist/src/public/experimental/channels/discord/gateway.d.ts +1 -0
  161. package/dist/src/public/experimental/channels/discord/gateway.js +1 -0
  162. package/dist/src/public/experimental/sandbox/just-bash.d.ts +1 -0
  163. package/dist/src/public/experimental/sandbox/just-bash.js +1 -0
  164. package/dist/src/public/experimental/workspace/index.d.ts +1 -0
  165. package/dist/src/public/experimental/workspace/index.js +1 -0
  166. package/dist/src/public/index.d.ts +2 -2
  167. package/dist/src/public/index.js +1 -1
  168. package/dist/src/public/instrumentation/otel.d.ts +1 -1
  169. package/dist/src/public/instrumentation/provider.d.ts +1 -1
  170. package/dist/src/public/instrumentation/provider.js +1 -1
  171. package/dist/src/public/memory/file/backend.d.ts +1 -1
  172. package/dist/src/public/memory/file/backends/in-memory.js +1 -1
  173. package/dist/src/public/memory/file/backends/vercel-blob.js +1 -1
  174. package/dist/src/public/memory/file/provider.js +1 -1
  175. package/dist/src/public/memory/index.d.ts +3 -11
  176. package/dist/src/public/models/anthropic/index.d.ts +1 -1
  177. package/dist/src/public/models/index.d.ts +1 -0
  178. package/dist/src/public/models/openai/index.d.ts +2 -2
  179. package/dist/src/public/next/index.d.ts +2 -2
  180. package/dist/src/public/sandbox/just-bash-sandbox.d.ts +27 -20
  181. package/dist/src/public/sandbox/just-bash.d.ts +0 -1
  182. package/dist/src/public/schedules/providers/vercel.d.ts +2 -0
  183. package/dist/src/public/schedules/providers/vercel.js +1 -1
  184. package/dist/src/public/sessions/index.d.ts +1 -0
  185. package/dist/src/public/sessions/index.js +1 -1
  186. package/dist/src/public/tools/index.d.ts +1 -1
  187. package/dist/src/public/tools/index.js +1 -1
  188. package/dist/src/public/workflow/api.d.ts +25 -0
  189. package/dist/src/public/workflow/api.js +1 -0
  190. package/dist/src/public/workflow/index.d.ts +76 -0
  191. package/dist/src/public/workflow/index.js +1 -0
  192. package/dist/src/public/workflow-modules.d.ts +2 -17
  193. package/dist/src/react/use-eve-agent.d.ts +3 -2
  194. package/dist/src/react/use-eve-agent.js +1 -1
  195. package/dist/src/reactions/kinds/model.js +1 -1
  196. package/dist/src/runtime/agent/resolve-model.js +1 -1
  197. package/dist/src/runtime/resolve-agent.js +1 -1
  198. package/dist/src/runtime/resolve-dynamic.js +1 -1
  199. package/dist/src/runtime/subagents/dynamic-agent-config.js +1 -1
  200. package/dist/src/runtime/subagents/workflow.js +1 -1
  201. package/dist/src/sandbox/providers/default.js +1 -1
  202. package/dist/src/self-modification/extension/subagents/agent/agent.d.ts +2 -2
  203. package/dist/src/self-modification/sandbox.js +1 -1
  204. package/dist/src/setup/integrations/discord/daemon.js +2 -2
  205. package/dist/src/setup/scaffold/create/project.js +2 -2
  206. package/dist/src/setup/scaffold/create/web-template.d.ts +2 -2
  207. package/dist/src/setup/scaffold/create/web-template.js +2 -2
  208. package/dist/src/setup/verified-remote-agent.d.ts +1 -3
  209. package/dist/src/shared/agent-definition.d.ts +18 -9
  210. package/dist/src/shared/eve-error.d.ts +22 -0
  211. package/dist/src/shared/eve-error.js +1 -0
  212. package/dist/src/shared/session.d.ts +2 -2
  213. package/dist/src/shared/token-usage.d.ts +7 -1
  214. package/dist/src/svelte/index.js +1 -1
  215. package/dist/src/svelte/use-eve-agent.d.ts +2 -1
  216. package/dist/src/svelte/use-eve-agent.js +1 -1
  217. package/dist/src/tools/definition.d.ts +7 -5
  218. package/dist/src/tools/definition.js +1 -1
  219. package/dist/src/tools/provided/ask-question-workflow.js +1 -1
  220. package/dist/src/tools/provided/sleep-workflow.js +1 -1
  221. package/dist/src/tracing/eve/batch-span-processor.d.ts +1 -1
  222. package/dist/src/tracing/eve/content-span-processor.d.ts +1 -19
  223. package/dist/src/tracing/eve/otel-configuration.d.ts +6 -0
  224. package/dist/src/tracing/eve/otel-declaration.d.ts +6 -19
  225. package/dist/src/tracing/eve/span-export-policy.d.ts +0 -2
  226. package/dist/src/tracing/local/instrumentation-runtime.d.ts +0 -3
  227. package/dist/src/tracing/local/traces.d.ts +0 -13
  228. package/dist/src/vue/index.js +1 -1
  229. package/dist/src/vue/use-eve-agent.d.ts +3 -2
  230. package/dist/src/vue/use-eve-agent.js +1 -1
  231. package/docs/agent-config.md +15 -11
  232. package/docs/channels/custom.mdx +26 -10
  233. package/docs/channels/discord.mdx +10 -10
  234. package/docs/channels/eve.mdx +15 -13
  235. package/docs/channels/linear.mdx +11 -0
  236. package/docs/channels/linq.mdx +5 -1
  237. package/docs/channels/photon.mdx +6 -1
  238. package/docs/channels/slack.mdx +73 -14
  239. package/docs/channels/telegram.mdx +6 -0
  240. package/docs/code-extension.mdx +25 -0
  241. package/docs/concepts/default-harness.md +2 -2
  242. package/docs/concepts/execution-model-and-durability.mdx +11 -11
  243. package/docs/concepts/project-structure.mdx +1 -1
  244. package/docs/concepts/security-model.md +6 -2
  245. package/docs/concepts/sessions-runs-and-streaming.md +23 -10
  246. package/docs/concepts/upgrade-to-v27-events.md +70 -1
  247. package/docs/connections/overview.mdx +4 -0
  248. package/docs/evals/reporters.mdx +21 -0
  249. package/docs/extensions.md +12 -0
  250. package/docs/getting-started.mdx +6 -0
  251. package/docs/guides/auth-and-route-protection.md +2 -1
  252. package/docs/guides/client/continuations.mdx +12 -10
  253. package/docs/guides/client/messages.mdx +24 -1
  254. package/docs/guides/client/overview.mdx +8 -6
  255. package/docs/guides/client/streaming.mdx +25 -7
  256. package/docs/guides/decide.md +3 -3
  257. package/docs/guides/deployment/self-hosting.md +1 -1
  258. package/docs/guides/deployment/vercel.mdx +1 -1
  259. package/docs/guides/dev-tui.md +2 -2
  260. package/docs/guides/frontend/meta.json +1 -0
  261. package/docs/guides/frontend/nextjs.mdx +329 -121
  262. package/docs/guides/frontend/overview.mdx +115 -335
  263. package/docs/guides/frontend/tanstack.mdx +1 -1
  264. package/docs/guides/frontend/use-eve-agent-svelte.mdx +18 -16
  265. package/docs/guides/frontend/use-eve-agent-vue.mdx +18 -16
  266. package/docs/guides/frontend/use-eve-agent.mdx +385 -0
  267. package/docs/guides/hooks.md +1 -1
  268. package/docs/guides/instrumentation/otel.mdx +3 -1
  269. package/docs/guides/prepare-for-1-0.md +255 -0
  270. package/docs/guides/remote-agents.md +26 -22
  271. package/docs/guides/self-modification.md +6 -0
  272. package/docs/instructions.mdx +1 -1
  273. package/docs/memory/custom-provider.md +1 -1
  274. package/docs/memory/file.md +11 -2
  275. package/docs/meta.json +1 -0
  276. package/docs/reference/agent-files.md +17 -17
  277. package/docs/reference/cli.md +15 -11
  278. package/docs/reference/typescript-api.md +46 -20
  279. package/docs/sandbox/custom-providers.mdx +2 -0
  280. package/docs/sandbox/default.mdx +6 -6
  281. package/docs/sandbox/index.mdx +6 -6
  282. package/docs/sandbox/just-bash.mdx +30 -21
  283. package/docs/subagents/index.mdx +4 -4
  284. package/docs/tools/human-in-the-loop.md +1 -1
  285. package/docs/tools/workflows.mdx +52 -8
  286. package/docs/tutorial/first-agent.mdx +1 -1
  287. package/package.json +46 -27
  288. package/dist/src/public/channels/discord/gateway/index.js +0 -1
  289. package/dist/src/self-modification/agent.d.ts +0 -12
  290. 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 | Required | Default | Description |
24
- | ------------------ | ----------------------- | -------- | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
25
- | `url` | `string` | Yes | n/a | Base URL of the remote eve deployment. Compute runtime URLs in a dynamic definition (see [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. |
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, reset, and stream reads use that original selection when
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 static `url` is read at compile time. When an environment variable supplies the URL only at runtime, compute it inside `defineDynamic`:
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 { defineDynamic, defineRemoteAgent } from "eve";
89
+ import { defineRemoteAgent } from "eve";
88
90
 
89
- export default defineDynamic(() =>
90
- defineRemoteAgent({
91
- url: process.env.WEATHER_AGENT_URL ?? "https://weather-agent.example.com",
92
- description: "Answers weather, temperature, forecast, wind, rain, and snow questions.",
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. `auth` and `headers` remain lazy callbacks resolved per request.
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 exact parent HTTPS origins, for example `https://parent.example.com`. The remote attaches its own short-lived Vercel OIDC token only to those origins and its own deployment origins; different ports and subdomains do not inherit trust. Keep the remote's Vercel OIDC token available at runtime. Callbacks do not follow redirects.
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 `POST /eve/v1/session/:childSessionId/reset` for it. An agent task's run finishes when the parent session ends. Reset retires the parked remote session and recursively cleans up its descendants. The request uses freshly resolved `headers` and `auth`; failures are logged so an unreachable remote cannot block parent finalization.
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.
@@ -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-reset) 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.
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
@@ -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
@@ -31,6 +31,7 @@
31
31
  "evals",
32
32
  "guides/instrumentation",
33
33
  "---Reference---",
34
+ "guides/prepare-for-1-0",
34
35
  "guides/dev-tui",
35
36
  "guides/self-modification",
36
37
  "...reference",
@@ -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, only `sandbox/sandbox.ts` is read. |
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
 
@@ -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>] [--channel-web-nextjs] [--non-interactive]
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
- | `--channel-web-nextjs` | flag | off | Add the Web Chat app (Next.js). Not for existing projects — run `eve add channel/web` there instead. |
59
- | `-n, --non-interactive` | flag | off | Scaffold and install dependencies without starting development. |
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>` | enum | `auto-collapsed` | Tool-call rendering |
283
- | `--reasoning <mode>` | enum | `full` | Reasoning rendering |
284
- | `--subagents <mode>` | enum | `collapsed` | Subagent task rendering: `full`, `collapsed`, or `hidden` |
285
- | `--connection-auth <mode>` | enum | `full` | Connection-authorization rendering |
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`