eve 0.90.0 → 0.91.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 (185) hide show
  1. package/CHANGELOG.md +34 -23
  2. package/dist/src/channel/auth/http-basic.js +1 -1
  3. package/dist/src/channel/channel-operations.d.ts +1 -1
  4. package/dist/src/channel/types.d.ts +2 -0
  5. package/dist/src/cli/dev/tui/prompt-commands.d.ts +1 -1
  6. package/dist/src/client/session.d.ts +1 -1
  7. package/dist/src/compiled/.vendor-stamp.json +1 -1
  8. package/dist/src/execution/dynamic-workflow/tool.js +1 -1
  9. package/dist/src/execution/proxied-deliver-step.js +1 -1
  10. package/dist/src/execution/sandbox/bash.js +2 -2
  11. package/dist/src/execution/session/active-turn.js +1 -1
  12. package/dist/src/execution/session/admission.d.ts +6 -0
  13. package/dist/src/execution/session/admission.js +1 -1
  14. package/dist/src/execution/session/delivery-facts.js +1 -1
  15. package/dist/src/execution/session/next-input.d.ts +2 -2
  16. package/dist/src/execution/session/next-input.js +1 -1
  17. package/dist/src/execution/session/program.js +1 -1
  18. package/dist/src/execution/session-inbox/inbox.d.ts +2 -2
  19. package/dist/src/execution/session-inbox/inbox.js +1 -1
  20. package/dist/src/execution/session-inbox/protocol.js +1 -1
  21. package/dist/src/execution/tools/agent-router-workflow.js +1 -1
  22. package/dist/src/harness/compaction/engine.js +2 -2
  23. package/dist/src/harness/current-messages.js +1 -1
  24. package/dist/src/harness/emission.d.ts +3 -0
  25. package/dist/src/harness/emission.js +1 -1
  26. package/dist/src/harness/facts.d.ts +5 -2
  27. package/dist/src/harness/facts.js +1 -1
  28. package/dist/src/harness/model-call/call.d.ts +7 -1
  29. package/dist/src/harness/model-call/call.js +3 -1
  30. package/dist/src/harness/provider-tool-history.d.ts +8 -0
  31. package/dist/src/harness/provider-tool-history.js +1 -1
  32. package/dist/src/harness/session-machine/transitions.d.ts +3 -2
  33. package/dist/src/harness/step/after-model.js +1 -1
  34. package/dist/src/harness/step/context.js +1 -1
  35. package/dist/src/harness/step/intake.js +1 -1
  36. package/dist/src/harness/step/prompt.js +1 -1
  37. package/dist/src/harness/tool-history-repair.d.ts +2 -0
  38. package/dist/src/harness/tool-history-repair.js +1 -1
  39. package/dist/src/harness/tool-loop.js +1 -1
  40. package/dist/src/internal/application/stamped-package-version.js +1 -1
  41. package/dist/src/protocol/session-events/families/delivery.d.ts +5 -3
  42. package/dist/src/protocol/session-events/families/delivery.js +1 -1
  43. package/dist/src/protocol/session-projection/fold.js +1 -1
  44. package/dist/src/public/channels/discord/hitl.js +1 -1
  45. package/dist/src/public/channels/slack/hitl.d.ts +2 -1
  46. package/dist/src/public/channels/slack/hitl.js +3 -3
  47. package/dist/src/public/channels/slack/interaction-cards.js +1 -1
  48. package/dist/src/public/channels/slack/request-card-render.js +1 -1
  49. package/dist/src/public/channels/teams/hitl.js +1 -1
  50. package/dist/src/public/channels/teams/verify.js +1 -1
  51. package/dist/src/public/definitions/hook.d.ts +90 -7
  52. package/dist/src/public/definitions/hook.js +1 -1
  53. package/dist/src/public/hooks/index.d.ts +3 -2
  54. package/dist/src/reactions/continuation.d.ts +19 -0
  55. package/dist/src/reactions/continuation.js +1 -0
  56. package/dist/src/reactions/intents.d.ts +10 -4
  57. package/dist/src/reactions/intents.js +1 -1
  58. package/dist/src/reactions/kinds/hook.js +1 -1
  59. package/dist/src/reactions/runner.js +1 -1
  60. package/dist/src/reactions/state.d.ts +15 -2
  61. package/dist/src/reactions/state.js +1 -1
  62. package/dist/src/runtime/resolve-connection.js +1 -1
  63. package/dist/src/runtime/subagents/workflow.js +1 -1
  64. package/dist/src/setup/primitives/open-url.js +1 -1
  65. package/dist/src/setup/scaffold/create/project.js +1 -1
  66. package/dist/src/shared/value-delta.d.ts +5 -4
  67. package/dist/src/shared/value-delta.js +1 -1
  68. package/dist/src/tools/provided/ask-question-workflow.js +1 -1
  69. package/dist/src/tools/provided/sleep-workflow.js +1 -1
  70. package/dist/src/tools/provided/web-fetch.js +1 -1
  71. package/docs/agent-config.md +199 -222
  72. package/docs/channels/chat-sdk.mdx +60 -64
  73. package/docs/channels/custom.mdx +264 -281
  74. package/docs/channels/discord.mdx +176 -123
  75. package/docs/channels/eve.mdx +136 -206
  76. package/docs/channels/github.mdx +24 -22
  77. package/docs/channels/linear.mdx +30 -30
  78. package/docs/channels/linq.mdx +25 -13
  79. package/docs/channels/mcp.mdx +154 -116
  80. package/docs/channels/overview.mdx +31 -32
  81. package/docs/channels/photon.mdx +32 -56
  82. package/docs/channels/slack.mdx +538 -375
  83. package/docs/channels/teams.mdx +40 -26
  84. package/docs/channels/telegram.mdx +13 -13
  85. package/docs/channels/twilio.mdx +11 -11
  86. package/docs/code-extension.mdx +40 -42
  87. package/docs/concepts/built-in-tools.md +89 -57
  88. package/docs/concepts/context-control.md +20 -20
  89. package/docs/concepts/default-harness.md +20 -36
  90. package/docs/concepts/execution-model-and-durability.mdx +96 -160
  91. package/docs/concepts/project-structure.mdx +21 -14
  92. package/docs/concepts/security-model.md +27 -27
  93. package/docs/concepts/sessions-runs-and-streaming.md +184 -198
  94. package/docs/concepts/state.md +7 -15
  95. package/docs/connections/mcp.mdx +109 -93
  96. package/docs/connections/openapi.mdx +57 -59
  97. package/docs/connections/overview.mdx +175 -170
  98. package/docs/evals/assertions.mdx +36 -29
  99. package/docs/evals/cases.mdx +38 -42
  100. package/docs/evals/judge.mdx +21 -29
  101. package/docs/evals/overview.mdx +42 -38
  102. package/docs/evals/reporters.mdx +54 -27
  103. package/docs/evals/running.mdx +15 -8
  104. package/docs/evals/targets.mdx +16 -19
  105. package/docs/evals/tool-stubs.mdx +111 -97
  106. package/docs/experimental/dynamic-schedules.mdx +118 -63
  107. package/docs/extensions.md +58 -65
  108. package/docs/getting-started.mdx +4 -6
  109. package/docs/guides/auth-and-route-protection.md +87 -70
  110. package/docs/guides/client/continuations.mdx +23 -26
  111. package/docs/guides/client/messages.mdx +47 -66
  112. package/docs/guides/client/output-schema.mdx +8 -8
  113. package/docs/guides/client/overview.mdx +45 -43
  114. package/docs/guides/client/streaming.mdx +62 -71
  115. package/docs/guides/decide.md +24 -79
  116. package/docs/guides/deployment/meta.json +1 -1
  117. package/docs/guides/deployment/overview.md +27 -18
  118. package/docs/guides/deployment/self-hosted-operations.md +99 -0
  119. package/docs/guides/deployment/self-hosting.md +63 -80
  120. package/docs/guides/deployment/vercel.mdx +31 -27
  121. package/docs/guides/deployment/workflow-worlds.md +100 -0
  122. package/docs/guides/dev-tui.md +48 -41
  123. package/docs/guides/dynamic-capabilities.md +49 -50
  124. package/docs/guides/frontend/nextjs.mdx +2 -2
  125. package/docs/guides/frontend/nuxt.mdx +11 -11
  126. package/docs/guides/frontend/overview.mdx +1 -1
  127. package/docs/guides/frontend/sveltekit.mdx +11 -11
  128. package/docs/guides/frontend/tanstack.mdx +16 -16
  129. package/docs/guides/frontend/use-eve-agent-svelte.mdx +21 -21
  130. package/docs/guides/frontend/use-eve-agent-vue.mdx +22 -22
  131. package/docs/guides/frontend/use-eve-agent.mdx +25 -25
  132. package/docs/guides/hooks.md +152 -106
  133. package/docs/guides/instrumentation/agent-runs.mdx +26 -30
  134. package/docs/guides/instrumentation/instrumentation.mdx +49 -76
  135. package/docs/guides/instrumentation/meta.json +1 -1
  136. package/docs/guides/instrumentation/otel.mdx +113 -179
  137. package/docs/guides/remote-agents.md +125 -187
  138. package/docs/guides/self-modification.md +18 -18
  139. package/docs/guides/session-context.md +16 -16
  140. package/docs/install-integrations.mdx +26 -24
  141. package/docs/instructions.mdx +37 -42
  142. package/docs/memory/custom-provider.md +35 -41
  143. package/docs/memory/file.md +93 -76
  144. package/docs/memory/overview.mdx +145 -156
  145. package/docs/patterns/durable-cross-channel-notifications.md +15 -19
  146. package/docs/patterns/dynamic-scheduling.md +19 -23
  147. package/docs/patterns/multi-tenant-approvals.md +17 -22
  148. package/docs/patterns/multi-tenant-auth.md +43 -42
  149. package/docs/patterns/multi-tenant-memory.md +39 -36
  150. package/docs/patterns/voice-notes.md +3 -3
  151. package/docs/protocols/acp.md +13 -13
  152. package/docs/protocols/ucp.mdx +7 -7
  153. package/docs/reference/agent-files.md +6 -6
  154. package/docs/reference/cli.md +99 -98
  155. package/docs/reference/telemetry.md +1 -1
  156. package/docs/reference/typescript-api.md +52 -53
  157. package/docs/responsible-use.md +2 -2
  158. package/docs/sandbox/custom-providers.mdx +60 -56
  159. package/docs/sandbox/default.mdx +23 -24
  160. package/docs/sandbox/docker.mdx +16 -10
  161. package/docs/sandbox/index.mdx +93 -61
  162. package/docs/sandbox/just-bash.mdx +17 -11
  163. package/docs/sandbox/troubleshooting.mdx +29 -23
  164. package/docs/sandbox/vercel.mdx +45 -52
  165. package/docs/schedules.mdx +65 -54
  166. package/docs/skills.mdx +74 -49
  167. package/docs/subagents/index.mdx +97 -136
  168. package/docs/tools/human-in-the-loop.md +160 -90
  169. package/docs/tools/meta.json +1 -1
  170. package/docs/tools/overview.mdx +229 -237
  171. package/docs/tools/tasks.md +118 -117
  172. package/docs/tools/workflows.mdx +447 -543
  173. package/docs/tutorial/connect-a-warehouse.mdx +11 -13
  174. package/docs/tutorial/first-agent.mdx +14 -16
  175. package/docs/tutorial/guard-the-spend.mdx +6 -8
  176. package/docs/tutorial/how-it-runs.mdx +8 -8
  177. package/docs/tutorial/query-sample-data.mdx +8 -8
  178. package/docs/tutorial/remember-definitions.mdx +4 -4
  179. package/docs/tutorial/run-analysis.mdx +20 -22
  180. package/docs/tutorial/ship-it.mdx +19 -19
  181. package/docs/tutorial/team-playbooks.mdx +9 -9
  182. package/docs/use-cases.mdx +13 -11
  183. package/package.json +1 -1
  184. package/docs/guides/instrumentation/migration.md +0 -96
  185. package/docs/tools/tasks-upgrade.md +0 -218
@@ -3,27 +3,25 @@ title: "File Memory"
3
3
  description: "Configure the built-in fileMemory() provider: a bounded, model-maintained document per scope with save and remove tools."
4
4
  ---
5
5
 
6
- `fileMemory()` from `eve/memory/file` is the memory provider built into eve.
7
- It keeps one small document per resolved scope, recalls that document before
8
- each turn, and gives the model two tools to maintain it.
9
- Use it when a short list of durable facts and preferences is enough; use
10
- [another provider](/docs/memory#choose-a-provider) when you need semantic
11
- retrieval or automatic capture.
6
+ `fileMemory()` from `eve/memory/file` is the memory provider built into eve. It
7
+ keeps one small document for each scope, such as each signed-in user, and gives
8
+ the model tools to edit it. Use it for a short list of facts and preferences
9
+ that later sessions need. For search over many records or automatic capture, use
10
+ [another provider](/docs/memory#choose-a-provider).
11
+
12
+ ```text
13
+ agent/
14
+ memory/
15
+ file.ts # the "file" slot
16
+ ```
12
17
 
13
- Add and provision file memory from an eve project:
18
+ Add file memory from an eve project:
14
19
 
15
20
  ```bash
16
21
  eve add memory/file
17
22
  ```
18
23
 
19
- After you choose **Install and set up**, eve creates or reuses one private
20
- Vercel Blob store for the linked project, connects it to production, preview,
21
- and development using OIDC, and pulls the updated environment. The connection
22
- sets `EVE_MEMORY_BLOB_STORE_ID` and `EVE_MEMORY_BLOB_WEBHOOK_PUBLIC_KEY`
23
- without adding a read-write token. It uses the project's first configured
24
- function region, falling back to `iad1`. Blob usage may incur charges.
25
-
26
- The registry writes:
24
+ The command writes:
27
25
 
28
26
  ```ts title="agent/memory/file.ts"
29
27
  import { defineMemory } from "eve/memory";
@@ -31,47 +29,60 @@ import { byPrincipal } from "eve/memory/scope";
31
29
  import { fileMemory } from "eve/memory/file";
32
30
 
33
31
  export default defineMemory({
32
+ // optional: prepended to the save and remove tool descriptions
34
33
  description: "Remember stable facts and preferences about the caller.",
34
+ // omit options to use the defaults in the options table
35
35
  provider: fileMemory(),
36
+ // required: one document for each signed-in caller
36
37
  scope: byPrincipal,
37
38
  });
38
39
  ```
39
40
 
41
+ Choose **Install and set up** to provision storage. eve creates or reuses one
42
+ private Vercel Blob store for the linked project. It connects the store to
43
+ production, preview, and development using OIDC, then pulls the updated
44
+ environment. The store uses the project's first configured function region, or
45
+ `iad1`. Blob usage may incur charges.
46
+
40
47
  ## How it behaves
41
48
 
42
- The provider implements recall and tools but no automatic capture. The model
43
- decides when to call `file__save_memory` and `file__remove_memory`, where
44
- `file` is the slot name. The slot `description` is prepended to both tool
45
- descriptions.
49
+ Before each turn, the provider gives the model the whole document as one
50
+ message. The model edits the document with two tools, `file__save_memory` and
51
+ `file__remove_memory`, where `file` is the slot name. The provider saves nothing
52
+ unless the model calls a tool.
46
53
 
47
- Each saved entry receives a permanent numeric index that the model uses to
48
- remove it later. The provider recalls the whole document as one message with a
49
- stable ID, so an updated or emptied document replaces the earlier recalled copy
50
- rather than accumulating beside it.
54
+ - Each saved entry gets a permanent number. The model removes an entry by that
55
+ number.
56
+ - An updated or emptied document replaces the copy the model saw earlier in the
57
+ session.
58
+ - Saving text identical to an existing entry does nothing.
59
+ - Saves and removals that run at the same time on one document don't overwrite
60
+ each other.
51
61
 
52
- The provider rejects writes that exceed its limits instead of truncating or
53
- evicting older entries:
62
+ The provider rejects a save that exceeds a limit. It doesn't shorten the entry
63
+ or delete older entries:
54
64
 
55
65
  | Limit | Value |
56
66
  | ---------------- | ------------------------------------------------ |
57
- | Recalled message | `maxCharacters`, default 4,000 |
67
+ | Recalled message | `maxCharacters` characters |
58
68
  | One entry | 2,048 UTF-8 bytes after whitespace normalization |
59
69
  | Stored document | 65,536 bytes |
60
70
 
61
- `maxCharacters` caps the exact recalled message, including its heading and
62
- removal guidance:
71
+ ## Options
72
+
73
+ | Option | Default | Effect |
74
+ | --------------- | ---------------------------------------------------------------- | -------------------------------------------------------------------------------- |
75
+ | `maxCharacters` | `4_000` | Caps the full message the model sees, including its heading and removal guidance |
76
+ | `backend` | Chosen by environment; see [Storage backends](#storage-backends) | Where the document is stored |
63
77
 
64
78
  ```ts
65
79
  provider: fileMemory({ maxCharacters: 8_000 });
66
80
  ```
67
81
 
68
- Saving text identical to an existing entry is a no-op. Concurrent writes to the
69
- same document use optimistic versioning and retry on conflict.
70
-
71
82
  ## Storage backends
72
83
 
73
- The document lives in a backend, not in the agent's sandbox filesystem. With no
74
- `backend` option, `fileMemory()` selects one lazily on first use:
84
+ The document lives in a backend, not in the agent's sandbox filesystem. Omit
85
+ `backend` to let `fileMemory()` select one on first use:
75
86
 
76
87
  | Environment | Backend |
77
88
  | ----------------------------------------------------------------- | ---------------------------------------------------------------------------- |
@@ -80,13 +91,13 @@ The document lives in a backend, not in the agent's sandbox filesystem. With no
80
91
  | `eve dev` | Shared process-local in-memory storage |
81
92
  | Every other environment | Error asking you for an explicit backend |
82
93
 
83
- `NODE_ENV=development` alone does not select in-memory storage, and a Blob
84
- token outside Vercel does not select Blob.
94
+ `NODE_ENV=development` alone does not select in-memory storage. A Blob token
95
+ outside Vercel does not select Blob.
85
96
 
86
97
  ### In-memory
87
98
 
88
- Pass a fresh in-memory backend for tests or throwaway environments. It loses
89
- its contents when the backend instance or process is replaced:
99
+ Pass an in-memory backend for tests or throwaway environments. It loses its
100
+ contents when the backend instance or process is replaced:
90
101
 
91
102
  ```ts
92
103
  import { fileMemory, inMemory } from "eve/memory/file";
@@ -96,11 +107,11 @@ provider: fileMemory({ backend: inMemory() });
96
107
 
97
108
  ### Vercel Blob
98
109
 
99
- Provisioned bindings use the `EVE_MEMORY_BLOB_*` namespace so file memory does
100
- not take over an application's own Blob store. Vercel supplies the OIDC token;
101
- the Blob SDK resolves the current token for each operation and handles refresh.
102
- File-memory reads and writes need the store ID. The webhook public key is for upload callbacks
103
- and is not used by file memory.
110
+ Setup connects the store with the `EVE_MEMORY_BLOB` prefix, so file memory
111
+ doesn't use an application's own Blob store. The connection sets
112
+ `EVE_MEMORY_BLOB_STORE_ID` and `EVE_MEMORY_BLOB_WEBHOOK_PUBLIC_KEY` without a
113
+ read-write token. File memory needs only the store ID, because Vercel supplies
114
+ the OIDC token. File memory doesn't use the webhook public key.
104
115
 
105
116
  `fileMemory()` checks Vercel configuration in this order:
106
117
 
@@ -109,30 +120,26 @@ and is not used by file memory.
109
120
  3. `BLOB_STORE_ID` with Vercel OIDC from the environment or request context
110
121
  4. `BLOB_READ_WRITE_TOKEN`
111
122
 
112
- Prefer OIDC on Vercel. You do not need to set a read-write token or copy
113
- `VERCEL_OIDC_TOKEN` into your configuration. Redeploy after connecting the
114
- store: changes to project environment variables apply to new deployments.
123
+ Prefer OIDC on Vercel, which needs no read-write token or copied
124
+ `VERCEL_OIDC_TOKEN`. Use the generic `BLOB_*` variables for a store you attach
125
+ manually. Redeploy after you connect the store, because project environment
126
+ variable changes apply only to new deployments.
115
127
 
116
- Generic `BLOB_*` variables remain supported for a store you attach manually.
117
- Run setup again without reinstalling the memory definition when a previous
118
- attempt stopped after creating or connecting the store:
128
+ If setup stopped after it created or connected the store, run it again. This
129
+ command doesn't reinstall the memory definition:
119
130
 
120
131
  ```bash
121
132
  eve integration setup file-memory
122
133
  ```
123
134
 
124
- Setup repairs the deterministic unconnected private store left by a partial
125
- run and reuses a complete `EVE_MEMORY_BLOB` connection. If an earlier setup
126
- created an `EVE_MEMORY_` connection, reconnect that same store with the
127
- `EVE_MEMORY_BLOB` prefix and OIDC in Vercel, then redeploy. Keep the existing
128
- store to preserve its memory documents. Setup does not adopt an arbitrary
129
- application store, change a `BLOB_*` connection, or replace a public
130
- or incompatible store. If the linked project later moves to another primary
131
- region, setup preserves the existing memory store and warns about the drift
132
- instead of risking data loss.
135
+ Setup repairs the unconnected private store that a partial run left. It reuses
136
+ a complete `EVE_MEMORY_BLOB` connection. It never adopts an arbitrary
137
+ application store, changes a `BLOB_*` connection, or replaces a public or
138
+ incompatible store. If the project moves to another primary region, setup keeps
139
+ the existing store and warns about the difference.
133
140
 
134
- Use `vercelBlob()` from `eve/memory/file/vercel` to configure credentials or an
135
- object prefix explicitly instead of relying on environment detection:
141
+ Use `vercelBlob()` from `eve/memory/file/vercel` to set credentials or an object
142
+ prefix in code instead of from the environment:
136
143
 
137
144
  ```ts
138
145
  import { fileMemory } from "eve/memory/file";
@@ -143,11 +150,10 @@ provider: fileMemory({
143
150
  });
144
151
  ```
145
152
 
146
- `vercelBlob()` accepts `token`, `oidcToken`, `storeId`, and `prefix`. The
147
- default prefix is `eve/memory/file`; documents are stored privately under
148
- `<prefix>/<scope key>/MEMORY.md`. Passing these options continues to override
149
- the generic environment defaults directly. Leave `oidcToken` unset on Vercel
150
- so the Blob SDK can manage token refresh.
153
+ `vercelBlob()` accepts `token`, `oidcToken`, `storeId`, and `prefix`, which
154
+ override the environment defaults. Documents are stored privately under
155
+ `prefix`. Omit `prefix` to use `eve/memory/file`. Leave `oidcToken` unset on
156
+ Vercel so the token refreshes automatically.
151
157
 
152
158
  ### Custom backend
153
159
 
@@ -162,10 +168,12 @@ export function kvBackend(store: KvStore): MemoryDocumentBackend {
162
168
  async read({ key, signal }) {
163
169
  signal.throwIfAborted();
164
170
  const row = await store.get(key);
171
+ // null means the document doesn't exist yet
165
172
  return row ? { content: row.content, version: row.version } : null;
166
173
  },
167
174
  async write({ key, content, expectedVersion, signal }) {
168
175
  signal.throwIfAborted();
176
+ // write the complete document only if the stored version still matches
169
177
  const ok = await store.compareAndSet(key, content, expectedVersion);
170
178
  if (!ok) throw new MemoryDocumentConflictError(key);
171
179
  return { content, version: await store.version(key) };
@@ -174,17 +182,26 @@ export function kvBackend(store: KvStore): MemoryDocumentBackend {
174
182
  }
175
183
  ```
176
184
 
177
- `write()` replaces the complete document and must throw
178
- `MemoryDocumentConflictError` when `expectedVersion` no longer matches. An
179
- `expectedVersion` of `null` means the document must not exist yet.
185
+ `write()` replaces the complete document. It must throw
186
+ `MemoryDocumentConflictError` when the stored version doesn't match
187
+ `expectedVersion`. An `expectedVersion` of `null` means the document must not
188
+ exist yet.
189
+
190
+ Both methods receive a `signal: AbortSignal`. Check it before starting work, and
191
+ pass it to storage calls that support cancellation. Memory and tool contexts
192
+ expose the same signal as `ctx.abortSignal`.
193
+
194
+ ## Troubleshooting
195
+
196
+ | What you see | What to do |
197
+ | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
198
+ | `fileMemory() requires Vercel Blob storage.` | Run `eve integration setup file-memory`, then redeploy. Or pass `fileMemory({ backend })`. |
199
+ | `fileMemory() requires an explicit backend outside Vercel and eve dev.` | Pass `fileMemory({ backend })`, because only Vercel and `eve dev` have a default backend. |
200
+ | `Memory would exceed the configured 4,000-character limit.` | Have the model remove outdated entries, or raise `maxCharacters`. |
201
+ | Setup reports that a store has an incompatible eve file-memory prefix | Reconnect the store in Vercel with the `EVE_MEMORY_BLOB` prefix and OIDC, then redeploy. Keeping the store keeps its documents. |
180
202
 
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`.
203
+ ## Choose another provider
187
204
 
188
- A backend changes only where the document is stored. It does not change file
189
- memory's recall format or tools. When you need different retrieval, capture, or
190
- tools, [build a memory provider](./custom-provider) instead.
205
+ A backend changes only where the document is stored, not the recall format or
206
+ tools. For different retrieval, capture, or tools,
207
+ [build a memory provider](./custom-provider) instead.