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.
- package/CHANGELOG.md +34 -23
- package/dist/src/channel/auth/http-basic.js +1 -1
- package/dist/src/channel/channel-operations.d.ts +1 -1
- package/dist/src/channel/types.d.ts +2 -0
- package/dist/src/cli/dev/tui/prompt-commands.d.ts +1 -1
- package/dist/src/client/session.d.ts +1 -1
- package/dist/src/compiled/.vendor-stamp.json +1 -1
- package/dist/src/execution/dynamic-workflow/tool.js +1 -1
- package/dist/src/execution/proxied-deliver-step.js +1 -1
- package/dist/src/execution/sandbox/bash.js +2 -2
- package/dist/src/execution/session/active-turn.js +1 -1
- package/dist/src/execution/session/admission.d.ts +6 -0
- package/dist/src/execution/session/admission.js +1 -1
- package/dist/src/execution/session/delivery-facts.js +1 -1
- package/dist/src/execution/session/next-input.d.ts +2 -2
- package/dist/src/execution/session/next-input.js +1 -1
- package/dist/src/execution/session/program.js +1 -1
- package/dist/src/execution/session-inbox/inbox.d.ts +2 -2
- package/dist/src/execution/session-inbox/inbox.js +1 -1
- package/dist/src/execution/session-inbox/protocol.js +1 -1
- package/dist/src/execution/tools/agent-router-workflow.js +1 -1
- package/dist/src/harness/compaction/engine.js +2 -2
- package/dist/src/harness/current-messages.js +1 -1
- package/dist/src/harness/emission.d.ts +3 -0
- package/dist/src/harness/emission.js +1 -1
- package/dist/src/harness/facts.d.ts +5 -2
- package/dist/src/harness/facts.js +1 -1
- package/dist/src/harness/model-call/call.d.ts +7 -1
- package/dist/src/harness/model-call/call.js +3 -1
- package/dist/src/harness/provider-tool-history.d.ts +8 -0
- package/dist/src/harness/provider-tool-history.js +1 -1
- package/dist/src/harness/session-machine/transitions.d.ts +3 -2
- package/dist/src/harness/step/after-model.js +1 -1
- package/dist/src/harness/step/context.js +1 -1
- package/dist/src/harness/step/intake.js +1 -1
- package/dist/src/harness/step/prompt.js +1 -1
- package/dist/src/harness/tool-history-repair.d.ts +2 -0
- package/dist/src/harness/tool-history-repair.js +1 -1
- package/dist/src/harness/tool-loop.js +1 -1
- package/dist/src/internal/application/stamped-package-version.js +1 -1
- package/dist/src/protocol/session-events/families/delivery.d.ts +5 -3
- package/dist/src/protocol/session-events/families/delivery.js +1 -1
- package/dist/src/protocol/session-projection/fold.js +1 -1
- package/dist/src/public/channels/discord/hitl.js +1 -1
- package/dist/src/public/channels/slack/hitl.d.ts +2 -1
- package/dist/src/public/channels/slack/hitl.js +3 -3
- package/dist/src/public/channels/slack/interaction-cards.js +1 -1
- package/dist/src/public/channels/slack/request-card-render.js +1 -1
- package/dist/src/public/channels/teams/hitl.js +1 -1
- package/dist/src/public/channels/teams/verify.js +1 -1
- package/dist/src/public/definitions/hook.d.ts +90 -7
- package/dist/src/public/definitions/hook.js +1 -1
- package/dist/src/public/hooks/index.d.ts +3 -2
- package/dist/src/reactions/continuation.d.ts +19 -0
- package/dist/src/reactions/continuation.js +1 -0
- package/dist/src/reactions/intents.d.ts +10 -4
- package/dist/src/reactions/intents.js +1 -1
- package/dist/src/reactions/kinds/hook.js +1 -1
- package/dist/src/reactions/runner.js +1 -1
- package/dist/src/reactions/state.d.ts +15 -2
- package/dist/src/reactions/state.js +1 -1
- package/dist/src/runtime/resolve-connection.js +1 -1
- package/dist/src/runtime/subagents/workflow.js +1 -1
- package/dist/src/setup/primitives/open-url.js +1 -1
- package/dist/src/setup/scaffold/create/project.js +1 -1
- package/dist/src/shared/value-delta.d.ts +5 -4
- package/dist/src/shared/value-delta.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/tools/provided/web-fetch.js +1 -1
- package/docs/agent-config.md +199 -222
- package/docs/channels/chat-sdk.mdx +60 -64
- package/docs/channels/custom.mdx +264 -281
- package/docs/channels/discord.mdx +176 -123
- package/docs/channels/eve.mdx +136 -206
- package/docs/channels/github.mdx +24 -22
- package/docs/channels/linear.mdx +30 -30
- package/docs/channels/linq.mdx +25 -13
- package/docs/channels/mcp.mdx +154 -116
- package/docs/channels/overview.mdx +31 -32
- package/docs/channels/photon.mdx +32 -56
- package/docs/channels/slack.mdx +538 -375
- package/docs/channels/teams.mdx +40 -26
- package/docs/channels/telegram.mdx +13 -13
- package/docs/channels/twilio.mdx +11 -11
- package/docs/code-extension.mdx +40 -42
- package/docs/concepts/built-in-tools.md +89 -57
- package/docs/concepts/context-control.md +20 -20
- package/docs/concepts/default-harness.md +20 -36
- package/docs/concepts/execution-model-and-durability.mdx +96 -160
- package/docs/concepts/project-structure.mdx +21 -14
- package/docs/concepts/security-model.md +27 -27
- package/docs/concepts/sessions-runs-and-streaming.md +184 -198
- package/docs/concepts/state.md +7 -15
- package/docs/connections/mcp.mdx +109 -93
- package/docs/connections/openapi.mdx +57 -59
- package/docs/connections/overview.mdx +175 -170
- package/docs/evals/assertions.mdx +36 -29
- package/docs/evals/cases.mdx +38 -42
- package/docs/evals/judge.mdx +21 -29
- package/docs/evals/overview.mdx +42 -38
- package/docs/evals/reporters.mdx +54 -27
- package/docs/evals/running.mdx +15 -8
- package/docs/evals/targets.mdx +16 -19
- package/docs/evals/tool-stubs.mdx +111 -97
- package/docs/experimental/dynamic-schedules.mdx +118 -63
- package/docs/extensions.md +58 -65
- package/docs/getting-started.mdx +4 -6
- package/docs/guides/auth-and-route-protection.md +87 -70
- package/docs/guides/client/continuations.mdx +23 -26
- package/docs/guides/client/messages.mdx +47 -66
- package/docs/guides/client/output-schema.mdx +8 -8
- package/docs/guides/client/overview.mdx +45 -43
- package/docs/guides/client/streaming.mdx +62 -71
- package/docs/guides/decide.md +24 -79
- package/docs/guides/deployment/meta.json +1 -1
- package/docs/guides/deployment/overview.md +27 -18
- package/docs/guides/deployment/self-hosted-operations.md +99 -0
- package/docs/guides/deployment/self-hosting.md +63 -80
- package/docs/guides/deployment/vercel.mdx +31 -27
- package/docs/guides/deployment/workflow-worlds.md +100 -0
- package/docs/guides/dev-tui.md +48 -41
- package/docs/guides/dynamic-capabilities.md +49 -50
- package/docs/guides/frontend/nextjs.mdx +2 -2
- package/docs/guides/frontend/nuxt.mdx +11 -11
- package/docs/guides/frontend/overview.mdx +1 -1
- package/docs/guides/frontend/sveltekit.mdx +11 -11
- package/docs/guides/frontend/tanstack.mdx +16 -16
- package/docs/guides/frontend/use-eve-agent-svelte.mdx +21 -21
- package/docs/guides/frontend/use-eve-agent-vue.mdx +22 -22
- package/docs/guides/frontend/use-eve-agent.mdx +25 -25
- package/docs/guides/hooks.md +152 -106
- package/docs/guides/instrumentation/agent-runs.mdx +26 -30
- package/docs/guides/instrumentation/instrumentation.mdx +49 -76
- package/docs/guides/instrumentation/meta.json +1 -1
- package/docs/guides/instrumentation/otel.mdx +113 -179
- package/docs/guides/remote-agents.md +125 -187
- package/docs/guides/self-modification.md +18 -18
- package/docs/guides/session-context.md +16 -16
- package/docs/install-integrations.mdx +26 -24
- package/docs/instructions.mdx +37 -42
- package/docs/memory/custom-provider.md +35 -41
- package/docs/memory/file.md +93 -76
- package/docs/memory/overview.mdx +145 -156
- package/docs/patterns/durable-cross-channel-notifications.md +15 -19
- package/docs/patterns/dynamic-scheduling.md +19 -23
- package/docs/patterns/multi-tenant-approvals.md +17 -22
- package/docs/patterns/multi-tenant-auth.md +43 -42
- package/docs/patterns/multi-tenant-memory.md +39 -36
- package/docs/patterns/voice-notes.md +3 -3
- package/docs/protocols/acp.md +13 -13
- package/docs/protocols/ucp.mdx +7 -7
- package/docs/reference/agent-files.md +6 -6
- package/docs/reference/cli.md +99 -98
- package/docs/reference/telemetry.md +1 -1
- package/docs/reference/typescript-api.md +52 -53
- package/docs/responsible-use.md +2 -2
- package/docs/sandbox/custom-providers.mdx +60 -56
- package/docs/sandbox/default.mdx +23 -24
- package/docs/sandbox/docker.mdx +16 -10
- package/docs/sandbox/index.mdx +93 -61
- package/docs/sandbox/just-bash.mdx +17 -11
- package/docs/sandbox/troubleshooting.mdx +29 -23
- package/docs/sandbox/vercel.mdx +45 -52
- package/docs/schedules.mdx +65 -54
- package/docs/skills.mdx +74 -49
- package/docs/subagents/index.mdx +97 -136
- package/docs/tools/human-in-the-loop.md +160 -90
- package/docs/tools/meta.json +1 -1
- package/docs/tools/overview.mdx +229 -237
- package/docs/tools/tasks.md +118 -117
- package/docs/tools/workflows.mdx +447 -543
- package/docs/tutorial/connect-a-warehouse.mdx +11 -13
- package/docs/tutorial/first-agent.mdx +14 -16
- package/docs/tutorial/guard-the-spend.mdx +6 -8
- package/docs/tutorial/how-it-runs.mdx +8 -8
- package/docs/tutorial/query-sample-data.mdx +8 -8
- package/docs/tutorial/remember-definitions.mdx +4 -4
- package/docs/tutorial/run-analysis.mdx +20 -22
- package/docs/tutorial/ship-it.mdx +19 -19
- package/docs/tutorial/team-playbooks.mdx +9 -9
- package/docs/use-cases.mdx +13 -11
- package/package.json +1 -1
- package/docs/guides/instrumentation/migration.md +0 -96
- package/docs/tools/tasks-upgrade.md +0 -218
package/docs/memory/file.md
CHANGED
|
@@ -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
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
[another provider](/docs/memory#choose-a-provider)
|
|
11
|
-
|
|
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
|
|
18
|
+
Add file memory from an eve project:
|
|
14
19
|
|
|
15
20
|
```bash
|
|
16
21
|
eve add memory/file
|
|
17
22
|
```
|
|
18
23
|
|
|
19
|
-
|
|
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
|
-
|
|
43
|
-
|
|
44
|
-
`file` is the slot name. The
|
|
45
|
-
|
|
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
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
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
|
|
53
|
-
|
|
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
|
|
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
|
-
|
|
62
|
-
|
|
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.
|
|
74
|
-
`backend`
|
|
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
|
|
84
|
-
|
|
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
|
|
89
|
-
|
|
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
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
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
|
|
113
|
-
`VERCEL_OIDC_TOKEN`
|
|
114
|
-
|
|
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
|
-
|
|
117
|
-
|
|
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
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
store
|
|
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
|
|
135
|
-
|
|
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
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
the
|
|
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
|
|
178
|
-
`MemoryDocumentConflictError` when
|
|
179
|
-
`expectedVersion` of `null` means the document must not
|
|
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
|
-
|
|
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
|
|
189
|
-
|
|
190
|
-
|
|
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.
|