eve 0.86.0 → 0.87.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +67 -0
- package/README.md +1 -1
- package/dist/src/acp/adapter.d.ts +2 -26
- package/dist/src/acp/adapter.js +1 -1
- package/dist/src/acp/server.d.ts +0 -3
- package/dist/src/ai/decision-adapter.d.ts +5 -3
- package/dist/src/ai/decision-adapter.js +1 -1
- package/dist/src/ai/decision-types.d.ts +4 -3
- package/dist/src/channel/adapter.d.ts +0 -14
- package/dist/src/channel/auth/definitions.d.ts +0 -4
- package/dist/src/channel/channel-address.d.ts +1 -1
- package/dist/src/channel/channel-address.js +1 -1
- package/dist/src/channel/channel-operations.d.ts +2 -2
- package/dist/src/channel/channel-operations.js +1 -1
- package/dist/src/channel/prompt-queue.d.ts +0 -2
- package/dist/src/channel/session-not-active-error.d.ts +10 -5
- package/dist/src/channel/session-not-active-error.js +1 -1
- package/dist/src/channel/session-stranded-error.d.ts +1 -1
- package/dist/src/channel/session.d.ts +3 -4
- package/dist/src/channel/session.js +1 -1
- package/dist/src/channel/types.d.ts +5 -14
- package/dist/src/chunks/{use-eve-agent-B2jCfcnG.js → use-eve-agent-BExXjBv6.js} +82 -72
- package/dist/src/chunks/{use-eve-agent-DCLFi26P.js → use-eve-agent-C0KHCyb9.js} +82 -72
- package/dist/src/cli/dev/command-options.d.ts +4 -4
- package/dist/src/cli/dev/command.js +1 -1
- package/dist/src/cli/dev/tui/runner.js +1 -1
- package/dist/src/cli/dev/tui/test/fake-eve-server.js +1 -1
- package/dist/src/cli/dev/tui/tool-format.d.ts +2 -2
- package/dist/src/cli/dev/ui-options.d.ts +4 -4
- package/dist/src/cli/dev/ui-options.js +1 -1
- package/dist/src/client/agent-info-error.d.ts +4 -1
- package/dist/src/client/agent-info-error.js +1 -1
- package/dist/src/client/agent-session.d.ts +1 -4
- package/dist/src/client/agent-session.js +1 -1
- package/dist/src/client/agent-stream-follower.js +1 -1
- package/dist/src/client/client-error.d.ts +13 -4
- package/dist/src/client/client-error.js +1 -1
- package/dist/src/client/delivery.d.ts +2 -17
- package/dist/src/client/health-response-error.d.ts +4 -1
- package/dist/src/client/health-response-error.js +1 -1
- package/dist/src/client/index.d.ts +5 -3
- package/dist/src/client/index.js +1 -1
- package/dist/src/client/open-stream.d.ts +7 -12
- package/dist/src/client/open-stream.js +1 -1
- package/dist/src/client/session-controls.d.ts +2 -2
- package/dist/src/client/session-controls.js +1 -1
- package/dist/src/client/session-event-stream.d.ts +2 -2
- package/dist/src/client/session-event-stream.js +1 -1
- package/dist/src/client/session-store.d.ts +2 -6
- package/dist/src/client/session-store.js +1 -1
- package/dist/src/client/session.d.ts +4 -13
- package/dist/src/client/session.js +1 -1
- package/dist/src/client/sessions.d.ts +3 -6
- package/dist/src/client/types.d.ts +23 -32
- package/dist/src/compiled/.vendor-stamp.json +3 -3
- package/dist/src/compiled/@vercel/agent-runs/LICENSE +202 -0
- package/dist/src/compiler/manifest.js +1 -1
- package/dist/src/compiler/normalize-agent-config.js +1 -1
- package/dist/src/compiler/normalize-connection.d.ts +1 -1
- package/dist/src/compiler/normalize-connection.js +1 -1
- package/dist/src/compiler/normalize-instructions.js +1 -1
- package/dist/src/compiler/normalize-skill.js +1 -1
- package/dist/src/compiler/resolve-workspace-subagent.js +1 -1
- package/dist/src/context/memory-tools.d.ts +9 -5
- package/dist/src/discover/sandbox.js +1 -1
- package/dist/src/dynamic/definition.d.ts +11 -5
- package/dist/src/dynamic/definition.js +1 -1
- package/dist/src/evals/mock-model.d.ts +1 -1
- package/dist/src/evals/session-manager.d.ts +0 -2
- package/dist/src/evals/session.d.ts +1 -11
- package/dist/src/evals/session.js +1 -1
- package/dist/src/eve-channel/index.js +1 -1
- package/dist/src/eve-channel/support.js +1 -1
- package/dist/src/execution/dynamic-workflow/tool.js +1 -1
- package/dist/src/execution/effective-agent-config.js +1 -1
- package/dist/src/execution/sandbox/bindings/just-bash-runtime.d.ts +1 -2
- package/dist/src/execution/sandbox/bindings/just-bash-runtime.js +1 -1
- package/dist/src/execution/sandbox/bindings/just-bash.js +1 -1
- package/dist/src/execution/tools/agent-router-workflow.js +1 -1
- package/dist/src/instrumentation/ai-sdk-telemetry.d.ts +0 -2
- package/dist/src/instrumentation/providers.d.ts +1 -38
- package/dist/src/instrumentation/providers.js +1 -1
- package/dist/src/instrumentation/setup-context.d.ts +1 -7
- package/dist/src/internal/application/package.d.ts +1 -0
- package/dist/src/internal/application/package.js +1 -1
- package/dist/src/internal/application/stamped-package-version.js +1 -1
- package/dist/src/internal/authored-definition/core.js +1 -1
- package/dist/src/internal/authored-definition/schema-backed.js +1 -1
- package/dist/src/internal/classify-model-routing.d.ts +2 -3
- package/dist/src/internal/nitro/host/create-application-nitro.js +1 -1
- package/dist/src/internal/runtime-model.d.ts +9 -4
- package/dist/src/internal/runtime-model.js +1 -1
- package/dist/src/internal/workflow-bundle/authored-workflow-directives.js +1 -1
- package/dist/src/internal/workflow-bundle/builder-support.d.ts +1 -1
- package/dist/src/internal/workflow-bundle/builder-support.js +1 -1
- package/dist/src/internal/workflow-bundle/workflow-transformer.js +1 -1
- package/dist/src/models/auto.js +1 -1
- package/dist/src/protocol/delivery.d.ts +1 -0
- package/dist/src/protocol/reset-session.d.ts +0 -2
- package/dist/src/protocol/routes.d.ts +9 -2
- package/dist/src/protocol/routes.js +1 -1
- package/dist/src/public/channels/chat-sdk/chatSdkChannel.d.ts +1 -22
- package/dist/src/public/channels/discord/discordChannel.d.ts +3 -12
- package/dist/src/public/channels/discord/gateway/{index.d.ts → relay.d.ts} +2 -2
- package/dist/src/public/channels/discord/gateway/relay.js +1 -0
- package/dist/src/public/channels/discord/messages.d.ts +4 -4
- package/dist/src/public/channels/github/state.d.ts +0 -2
- package/dist/src/public/channels/index.d.ts +1 -2
- package/dist/src/public/channels/index.js +1 -1
- package/dist/src/public/channels/linear/index.d.ts +1 -1
- package/dist/src/public/channels/linear/index.js +1 -1
- package/dist/src/public/channels/linear/linearChannel.d.ts +0 -5
- package/dist/src/public/channels/linq/index.d.ts +1 -1
- package/dist/src/public/channels/linq/linqChannel.d.ts +7 -5
- package/dist/src/public/channels/photon/index.d.ts +1 -1
- package/dist/src/public/channels/photon/photonIMessageChannel.d.ts +15 -4
- package/dist/src/public/channels/slack/api.d.ts +1 -1
- package/dist/src/public/channels/slack/api.js +1 -1
- package/dist/src/public/channels/slack/blocks.d.ts +1 -1
- package/dist/src/public/channels/slack/blocks.js +2 -2
- package/dist/src/public/channels/slack/cards.d.ts +2 -297
- package/dist/src/public/channels/slack/cards.js +1 -1
- package/dist/src/public/channels/slack/index.d.ts +2 -2
- package/dist/src/public/channels/slack/index.js +1 -1
- package/dist/src/public/channels/slack/session-operations.d.ts +2 -2
- package/dist/src/public/channels/slack/session-operations.js +1 -1
- package/dist/src/public/channels/slack/slackChannel.d.ts +11 -72
- package/dist/src/public/channels/slack/slackChannel.js +1 -1
- package/dist/src/public/channels/teams/teamsChannel.d.ts +4 -3
- package/dist/src/public/channels/telegram/hitl.d.ts +2 -9
- package/dist/src/public/channels/telegram/index.d.ts +1 -1
- package/dist/src/public/channels/telegram/telegramChannel.d.ts +0 -2
- package/dist/src/public/channels/twilio/twilioChannel.d.ts +0 -2
- package/dist/src/public/channels/undelivered-reply.d.ts +0 -5
- package/dist/src/public/definitions/agent.d.ts +15 -7
- package/dist/src/public/definitions/agent.js +1 -1
- package/dist/src/public/definitions/channel.d.ts +7 -5
- package/dist/src/public/definitions/channel.js +1 -1
- package/dist/src/public/definitions/connections/protocol.d.ts +1 -7
- package/dist/src/public/definitions/connections/protocol.js +1 -1
- package/dist/src/public/experimental/channels/discord/gateway.d.ts +1 -0
- package/dist/src/public/experimental/channels/discord/gateway.js +1 -0
- package/dist/src/public/experimental/sandbox/just-bash.d.ts +1 -0
- package/dist/src/public/experimental/sandbox/just-bash.js +1 -0
- package/dist/src/public/experimental/workspace/index.d.ts +1 -0
- package/dist/src/public/experimental/workspace/index.js +1 -0
- package/dist/src/public/index.d.ts +2 -2
- package/dist/src/public/index.js +1 -1
- package/dist/src/public/instrumentation/otel.d.ts +1 -1
- package/dist/src/public/instrumentation/provider.d.ts +1 -1
- package/dist/src/public/instrumentation/provider.js +1 -1
- package/dist/src/public/memory/file/backend.d.ts +1 -1
- package/dist/src/public/memory/file/backends/in-memory.js +1 -1
- package/dist/src/public/memory/file/backends/vercel-blob.js +1 -1
- package/dist/src/public/memory/file/provider.js +1 -1
- package/dist/src/public/memory/index.d.ts +3 -11
- package/dist/src/public/models/anthropic/index.d.ts +1 -1
- package/dist/src/public/models/index.d.ts +1 -0
- package/dist/src/public/models/openai/index.d.ts +2 -2
- package/dist/src/public/next/index.d.ts +2 -2
- package/dist/src/public/sandbox/just-bash-sandbox.d.ts +27 -20
- package/dist/src/public/sandbox/just-bash.d.ts +0 -1
- package/dist/src/public/sessions/index.d.ts +1 -0
- package/dist/src/public/sessions/index.js +1 -1
- package/dist/src/public/tools/index.d.ts +1 -1
- package/dist/src/public/tools/index.js +1 -1
- package/dist/src/public/workflow/api.d.ts +25 -0
- package/dist/src/public/workflow/api.js +1 -0
- package/dist/src/public/workflow/index.d.ts +76 -0
- package/dist/src/public/workflow/index.js +1 -0
- package/dist/src/public/workflow-modules.d.ts +2 -17
- package/dist/src/react/use-eve-agent.d.ts +3 -2
- package/dist/src/react/use-eve-agent.js +1 -1
- package/dist/src/reactions/kinds/model.js +1 -1
- package/dist/src/runtime/agent/resolve-model.js +1 -1
- package/dist/src/runtime/resolve-agent.js +1 -1
- package/dist/src/runtime/resolve-dynamic.js +1 -1
- package/dist/src/runtime/subagents/dynamic-agent-config.js +1 -1
- package/dist/src/runtime/subagents/workflow.js +1 -1
- package/dist/src/sandbox/providers/default.js +1 -1
- package/dist/src/self-modification/extension/subagents/agent/agent.d.ts +2 -2
- package/dist/src/self-modification/sandbox.js +1 -1
- package/dist/src/setup/integrations/discord/daemon.js +2 -2
- package/dist/src/setup/scaffold/create/project.js +2 -2
- package/dist/src/setup/scaffold/create/web-template.d.ts +2 -2
- package/dist/src/setup/scaffold/create/web-template.js +2 -2
- package/dist/src/setup/verified-remote-agent.d.ts +1 -3
- package/dist/src/shared/agent-definition.d.ts +18 -9
- package/dist/src/shared/eve-error.d.ts +22 -0
- package/dist/src/shared/eve-error.js +1 -0
- package/dist/src/shared/session.d.ts +2 -2
- package/dist/src/shared/token-usage.d.ts +7 -1
- package/dist/src/svelte/index.js +1 -1
- package/dist/src/svelte/use-eve-agent.d.ts +2 -1
- package/dist/src/svelte/use-eve-agent.js +1 -1
- package/dist/src/tools/definition.d.ts +7 -5
- package/dist/src/tools/definition.js +1 -1
- package/dist/src/tools/provided/ask-question-workflow.js +1 -1
- package/dist/src/tools/provided/sleep-workflow.js +1 -1
- package/dist/src/tracing/eve/batch-span-processor.d.ts +1 -1
- package/dist/src/tracing/eve/content-span-processor.d.ts +1 -19
- package/dist/src/tracing/eve/otel-configuration.d.ts +6 -0
- package/dist/src/tracing/eve/otel-declaration.d.ts +6 -19
- package/dist/src/tracing/eve/span-export-policy.d.ts +0 -2
- package/dist/src/tracing/local/instrumentation-runtime.d.ts +0 -3
- package/dist/src/tracing/local/traces.d.ts +0 -13
- package/dist/src/vue/index.js +1 -1
- package/dist/src/vue/use-eve-agent.d.ts +3 -2
- package/dist/src/vue/use-eve-agent.js +1 -1
- package/docs/agent-config.md +15 -11
- package/docs/channels/custom.mdx +26 -10
- package/docs/channels/discord.mdx +10 -10
- package/docs/channels/eve.mdx +14 -8
- package/docs/channels/linear.mdx +11 -0
- package/docs/channels/linq.mdx +5 -1
- package/docs/channels/photon.mdx +6 -1
- package/docs/channels/slack.mdx +73 -14
- package/docs/channels/telegram.mdx +6 -0
- package/docs/code-extension.mdx +25 -0
- package/docs/concepts/default-harness.md +2 -2
- package/docs/concepts/execution-model-and-durability.mdx +11 -11
- package/docs/concepts/security-model.md +2 -2
- package/docs/concepts/sessions-runs-and-streaming.md +23 -10
- package/docs/concepts/upgrade-to-v27-events.md +2 -1
- package/docs/connections/overview.mdx +4 -0
- package/docs/evals/reporters.mdx +21 -0
- package/docs/extensions.md +12 -0
- package/docs/getting-started.mdx +5 -1
- package/docs/guides/auth-and-route-protection.md +1 -1
- package/docs/guides/client/continuations.mdx +12 -10
- package/docs/guides/client/messages.mdx +24 -1
- package/docs/guides/client/overview.mdx +8 -6
- package/docs/guides/client/streaming.mdx +24 -6
- package/docs/guides/decide.md +3 -3
- package/docs/guides/deployment/vercel.mdx +1 -1
- package/docs/guides/dev-tui.md +2 -2
- package/docs/guides/frontend/overview.mdx +1 -1
- package/docs/guides/frontend/use-eve-agent-svelte.mdx +13 -11
- package/docs/guides/frontend/use-eve-agent-vue.mdx +13 -11
- package/docs/guides/frontend/use-eve-agent.mdx +4 -4
- package/docs/guides/instrumentation/otel.mdx +3 -1
- package/docs/guides/prepare-for-1-0.md +255 -0
- package/docs/guides/remote-agents.md +22 -20
- package/docs/instructions.mdx +1 -1
- package/docs/memory/custom-provider.md +1 -1
- package/docs/memory/file.md +11 -2
- package/docs/meta.json +1 -0
- package/docs/reference/agent-files.md +17 -17
- package/docs/reference/cli.md +14 -9
- package/docs/reference/typescript-api.md +46 -20
- package/docs/sandbox/custom-providers.mdx +2 -0
- package/docs/sandbox/default.mdx +6 -6
- package/docs/sandbox/index.mdx +5 -5
- package/docs/sandbox/just-bash.mdx +30 -21
- package/docs/subagents/index.mdx +4 -4
- package/docs/tools/human-in-the-loop.md +1 -1
- package/docs/tools/workflows.mdx +52 -8
- package/docs/tutorial/first-agent.mdx +1 -1
- package/package.json +36 -9
- package/dist/CHANGELOG.md +0 -38
- package/dist/src/public/channels/discord/gateway/index.js +0 -1
package/docs/tools/workflows.mdx
CHANGED
|
@@ -81,9 +81,10 @@ or days later, the run resumes, deploys, and returns. The model sees one tool re
|
|
|
81
81
|
- `"use step"` marks a top-level `async function` in the tool module, or any module it imports, as a
|
|
82
82
|
step. Side effects, clocks, randomness, `process.env`, and Node.js APIs belong in steps; the body
|
|
83
83
|
is replayed and must stay deterministic.
|
|
84
|
-
- Import `createHook`, `createWebhook`, `sleep`,
|
|
85
|
-
`start`, `getRun`, and `resumeHook` from
|
|
86
|
-
|
|
84
|
+
- Import `createHook`, `createWebhook`, `sleep`, `FatalError`, `RetryableError`, and `getWorkflowMetadata` from
|
|
85
|
+
`eve/workflow` in the body. Import `start`, `getRun`, and `resumeHook` from
|
|
86
|
+
`eve/workflow/api` in routes or steps, not in replayed bodies. Both entries use eve's bundled
|
|
87
|
+
SDK; no separate `workflow` dependency or ambient tsconfig `types` entry is needed.
|
|
87
88
|
- In an `execute` or `task` body, `ctx` is a `WorkflowToolContext` with `session`, `callId`,
|
|
88
89
|
`toolName`, `abortSignal`, `channel`, `agent`, `agents`, and `ask`. A `serve` body gets a
|
|
89
90
|
`WorkflowServeContext` with `session`, `toolName`, `channel`,
|
|
@@ -114,6 +115,48 @@ eve includes only workflow and step modules reachable from the agent's runtime m
|
|
|
114
115
|
Unrelated workflows in the host application stay outside the agent bundle. An unresolved
|
|
115
116
|
workflow import fails the build with the missing import in the error.
|
|
116
117
|
|
|
118
|
+
### Workflow imports
|
|
119
|
+
|
|
120
|
+
Use `eve/workflow` for durable primitives and `eve/workflow/api` for run and hook operations:
|
|
121
|
+
|
|
122
|
+
```ts
|
|
123
|
+
import { createHook, sleep } from "eve/workflow";
|
|
124
|
+
import { resumeHook } from "eve/workflow/api";
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
`eve/workflow` exports:
|
|
128
|
+
|
|
129
|
+
- `createHook<T>({ token?, metadata? })` returns a `WorkflowHook<T>`. Await it for the next payload
|
|
130
|
+
or iterate it with `for await`. Its `token` resumes it; `metadata` is JSON stored with the hook.
|
|
131
|
+
`await hook.getConflict()` registers the hook before you hand out its token and resolves the run
|
|
132
|
+
that already owns the token, or `null`. `dispose()`, or `using`, releases the token.
|
|
133
|
+
- `createWebhook({ respondWith? })` returns a `WorkflowWebhook` whose `url` resumes it with the
|
|
134
|
+
incoming `Request`. With `respondWith: "manual"`, each request is a `WorkflowWebhookRequest`
|
|
135
|
+
that you answer with `request.respondWith(response)`.
|
|
136
|
+
- `sleep(duration)` takes a duration such as `"1h"`, milliseconds, or a `Date` to wait until.
|
|
137
|
+
- `getWorkflowMetadata()` returns the current run's `workflowName`, `workflowRunId`,
|
|
138
|
+
`workflowStartedAt`, and `url`.
|
|
139
|
+
- Throw `FatalError` to fail without retrying, or `RetryableError` with an optional
|
|
140
|
+
`{ retryAfter }` to retry a step.
|
|
141
|
+
|
|
142
|
+
Import `WorkflowHook`, `WorkflowHookOptions`, `WorkflowWebhook`, `WorkflowWebhookOptions`,
|
|
143
|
+
`WorkflowWebhookRequest`, and `WorkflowMetadata` from `eve/workflow` when you need explicit types.
|
|
144
|
+
|
|
145
|
+
`eve/workflow/api` exports:
|
|
146
|
+
|
|
147
|
+
- `start(workflow, args)` starts a `"use workflow"` function; omit `args` when it takes none. eve
|
|
148
|
+
routes the run to the agent's own workflow queue and deployment, so `start` takes no options.
|
|
149
|
+
- `start` and `getRun(runId)` return a `WorkflowRun<T>` with `runId`, `status` (a promise of
|
|
150
|
+
`WorkflowRunStatus`), `returnValue`, and `cancel()`.
|
|
151
|
+
- `resumeHook(token, payload)` delivers a payload to the hook with that token. Pass a
|
|
152
|
+
deterministic `token` to `createHook` when a route must find the hook later.
|
|
153
|
+
|
|
154
|
+
Bare `workflow` and `workflow/*` imports in application modules fail the build with an error
|
|
155
|
+
naming these entries. Only the exports listed above are public; other SDK subpaths, helpers, and
|
|
156
|
+
options are not supported by these entries. Existing `"types": ["eve/workflow-modules"]` tsconfig entries and reference
|
|
157
|
+
directives still resolve through 1.x, but the compatibility entry declares no ambient modules.
|
|
158
|
+
You can remove those references when updating your imports.
|
|
159
|
+
|
|
117
160
|
### Add a runtime-generated workflow tool
|
|
118
161
|
|
|
119
162
|
Create `agent/tools/workflow.ts` and export the provided `workflow` factory when the model should
|
|
@@ -189,8 +232,9 @@ an agent catalog. Calls use the same target resolution, availability, and author
|
|
|
189
232
|
|
|
190
233
|
Replace `defineTool` with `defineWorkflowTool`, keep the executor's `"use workflow"` directive,
|
|
191
234
|
and replace `agent(ctx, input)` and `ask(ctx, request)` with an agent session from
|
|
192
|
-
[`ctx.agent(name)`](#delegate-work-ctxagent) and `ctx.ask(request)`. The `
|
|
193
|
-
|
|
235
|
+
[`ctx.agent(name)`](#delegate-work-ctxagent) and `ctx.ask(request)`. The old `agent` and `ask`
|
|
236
|
+
helpers are not exported from `eve/workflow`; that entry exposes durable primitives instead.
|
|
237
|
+
Import `WorkflowToolContext`, `AgentSession`,
|
|
194
238
|
`ToolQuestion`, `ToolAskOptions`, and `ToolAnswer` from `eve/tools` when you
|
|
195
239
|
need explicit types.
|
|
196
240
|
|
|
@@ -844,7 +888,7 @@ This workflow reports progress, then suspends until its timer expires:
|
|
|
844
888
|
|
|
845
889
|
```ts title="agent/tools/remind_with_progress.ts"
|
|
846
890
|
import { defineWorkflowTool } from "eve/tools";
|
|
847
|
-
import { sleep } from "workflow";
|
|
891
|
+
import { sleep } from "eve/workflow";
|
|
848
892
|
import { z } from "zod";
|
|
849
893
|
|
|
850
894
|
export default defineWorkflowTool({
|
|
@@ -912,7 +956,7 @@ you have. After a cancel, eve discards the result. The provided `sleep` tool rac
|
|
|
912
956
|
against the signal:
|
|
913
957
|
|
|
914
958
|
```ts
|
|
915
|
-
import { sleep } from "workflow";
|
|
959
|
+
import { sleep } from "eve/workflow";
|
|
916
960
|
|
|
917
961
|
async execute(input, ctx) {
|
|
918
962
|
"use workflow";
|
|
@@ -960,7 +1004,7 @@ conversation, and a steering message doesn't withdraw the request. `sleep` is th
|
|
|
960
1004
|
|
|
961
1005
|
```ts title="agent/tools/render_video.ts"
|
|
962
1006
|
import { defineWorkflowTool } from "eve/tools";
|
|
963
|
-
import { createWebhook, FatalError } from "workflow";
|
|
1007
|
+
import { createWebhook, FatalError } from "eve/workflow";
|
|
964
1008
|
import { z } from "zod";
|
|
965
1009
|
import { submitRender } from "../lib/render";
|
|
966
1010
|
|
|
@@ -3,7 +3,7 @@ title: "Your First Agent"
|
|
|
3
3
|
description: "Scaffold the analytics assistant, give it an analyst persona, run it, and ask a question."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
For a bespoke learning experience, start with the [eve template gallery](https://
|
|
6
|
+
For a bespoke learning experience, start with the [eve template gallery](https://vercel.com/templates/eve) or ask your coding agent to build your use case. For example:
|
|
7
7
|
|
|
8
8
|
- “Build an eve Slack agent that answers questions from our team’s documentation.”
|
|
9
9
|
- “Build an eve incident-response agent that investigates alerts using our observability tools.”
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "eve",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.87.0",
|
|
4
4
|
"private": false,
|
|
5
5
|
"description": "Filesystem-first framework for durable backend AI agents that run anywhere.",
|
|
6
6
|
"keywords": [
|
|
@@ -37,9 +37,11 @@
|
|
|
37
37
|
"files": [
|
|
38
38
|
"bin",
|
|
39
39
|
"dist",
|
|
40
|
+
"!dist/CHANGELOG.md",
|
|
40
41
|
"docs",
|
|
41
42
|
"NOTICE",
|
|
42
|
-
"README.md"
|
|
43
|
+
"README.md",
|
|
44
|
+
"CHANGELOG.md"
|
|
43
45
|
],
|
|
44
46
|
"type": "module",
|
|
45
47
|
"sideEffects": true,
|
|
@@ -202,6 +204,18 @@
|
|
|
202
204
|
"import": "./dist/src/public/tools/workflow.js",
|
|
203
205
|
"default": "./dist/src/public/tools/workflow.js"
|
|
204
206
|
},
|
|
207
|
+
"./workflow": {
|
|
208
|
+
"eve-source": "./src/public/workflow/index.ts",
|
|
209
|
+
"types": "./dist/src/public/workflow/index.d.ts",
|
|
210
|
+
"import": "./dist/src/public/workflow/index.js",
|
|
211
|
+
"default": "./dist/src/public/workflow/index.js"
|
|
212
|
+
},
|
|
213
|
+
"./workflow/api": {
|
|
214
|
+
"eve-source": "./src/public/workflow/api.ts",
|
|
215
|
+
"types": "./dist/src/public/workflow/api.d.ts",
|
|
216
|
+
"import": "./dist/src/public/workflow/api.js",
|
|
217
|
+
"default": "./dist/src/public/workflow/api.js"
|
|
218
|
+
},
|
|
205
219
|
"./workflow-modules": {
|
|
206
220
|
"eve-source": "./dist/src/public/workflow-modules.d.ts",
|
|
207
221
|
"types": "./dist/src/public/workflow-modules.d.ts"
|
|
@@ -388,6 +402,24 @@
|
|
|
388
402
|
"import": "./dist/src/public/server/index.js",
|
|
389
403
|
"default": "./dist/src/public/server/index.js"
|
|
390
404
|
},
|
|
405
|
+
"./experimental/workspace": {
|
|
406
|
+
"eve-source": "./src/public/experimental/workspace/index.ts",
|
|
407
|
+
"types": "./dist/src/public/experimental/workspace/index.d.ts",
|
|
408
|
+
"import": "./dist/src/public/experimental/workspace/index.js",
|
|
409
|
+
"default": "./dist/src/public/experimental/workspace/index.js"
|
|
410
|
+
},
|
|
411
|
+
"./experimental/sandbox/just-bash": {
|
|
412
|
+
"eve-source": "./src/public/experimental/sandbox/just-bash.ts",
|
|
413
|
+
"types": "./dist/src/public/experimental/sandbox/just-bash.d.ts",
|
|
414
|
+
"import": "./dist/src/public/experimental/sandbox/just-bash.js",
|
|
415
|
+
"default": "./dist/src/public/experimental/sandbox/just-bash.js"
|
|
416
|
+
},
|
|
417
|
+
"./experimental/channels/discord/gateway": {
|
|
418
|
+
"eve-source": "./src/public/experimental/channels/discord/gateway.ts",
|
|
419
|
+
"types": "./dist/src/public/experimental/channels/discord/gateway.d.ts",
|
|
420
|
+
"import": "./dist/src/public/experimental/channels/discord/gateway.js",
|
|
421
|
+
"default": "./dist/src/public/experimental/channels/discord/gateway.js"
|
|
422
|
+
},
|
|
391
423
|
"./experimental/schedules/testing": {
|
|
392
424
|
"eve-source": "./src/public/experimental/schedules/testing.ts",
|
|
393
425
|
"types": "./dist/src/public/experimental/schedules/testing.d.ts",
|
|
@@ -456,11 +488,6 @@
|
|
|
456
488
|
"import": "./dist/src/public/channels/discord/index.js",
|
|
457
489
|
"default": "./dist/src/public/channels/discord/index.js"
|
|
458
490
|
},
|
|
459
|
-
"./channels/discord/gateway": {
|
|
460
|
-
"types": "./dist/src/public/channels/discord/gateway/index.d.ts",
|
|
461
|
-
"import": "./dist/src/public/channels/discord/gateway/index.js",
|
|
462
|
-
"default": "./dist/src/public/channels/discord/gateway/index.js"
|
|
463
|
-
},
|
|
464
491
|
"./channels/twilio": {
|
|
465
492
|
"types": "./dist/src/public/channels/twilio/index.d.ts",
|
|
466
493
|
"import": "./dist/src/public/channels/twilio/index.js",
|
|
@@ -604,7 +631,7 @@
|
|
|
604
631
|
"@types/json-schema": "7.0.15",
|
|
605
632
|
"@types/react": "19.2.15",
|
|
606
633
|
"@types/react-test-renderer": "19.1.0",
|
|
607
|
-
"@vercel/agent-runs": "0.0.
|
|
634
|
+
"@vercel/agent-runs": "0.0.3",
|
|
608
635
|
"@vercel/blob": "2.8.0",
|
|
609
636
|
"@vercel/connect": "2.5.2",
|
|
610
637
|
"@vercel/detect-agent": "1.2.3",
|
|
@@ -734,7 +761,7 @@
|
|
|
734
761
|
},
|
|
735
762
|
"scripts": {
|
|
736
763
|
"clean": "node -e \"fs.rmSync('dist', { recursive: true, force: true })\"",
|
|
737
|
-
"build": "pnpm run check:bin-runtime-dependencies && node ./scripts/build-js.mjs && node ./scripts/copy-docs.mjs && node ./scripts/stamp-version-tokens.mjs",
|
|
764
|
+
"build": "pnpm run check:bin-runtime-dependencies && node ./scripts/build-js.mjs && node ./scripts/copy-docs.mjs && node ./scripts/stamp-version-tokens.mjs && node ../../scripts/copy-package-license.mjs . && node ../../scripts/stage-package.mjs .",
|
|
738
765
|
"build:compiled": "node ./scripts/vendor-compiled.mjs",
|
|
739
766
|
"build:js": "node ./scripts/build-js.mjs",
|
|
740
767
|
"build:types": "tsc -p tsconfig.build.json",
|
package/dist/CHANGELOG.md
DELETED
|
@@ -1,38 +0,0 @@
|
|
|
1
|
-
# Release eve@0.86.0 | 2026-10-28 | minor
|
|
2
|
-
|
|
3
|
-
## 🚀 Features
|
|
4
|
-
|
|
5
|
-
- `EVE_CALLBACK_TRUSTED_ORIGINS` now accepts a leading `*.` label, such as `https://*.preview.example.com`, so a remote agent can trust preview parents whose deployment URLs change on every deploy. [#5539](https://github.com/vercel/eve/pull/5539)
|
|
6
|
-
|
|
7
|
-
The wildcard matches exactly one subdomain label, and `*.vercel.app` and trailing dots are rejected.
|
|
8
|
-
|
|
9
|
-
- Hide `eve init --channel-web-nextjs` from `eve init --help` in favor of `eve add channel/web`. [#5474](https://github.com/vercel/eve/pull/5474)
|
|
10
|
-
|
|
11
|
-
The flag still works. The README and coding-agent setup instructions now point to `eve add channel/web`, which also sets up sign-in.
|
|
12
|
-
|
|
13
|
-
- Ship current release notes at `dist/CHANGELOG.md` with a version-pinned link to the full changelog. [#5446](https://github.com/vercel/eve/pull/5446)
|
|
14
|
-
|
|
15
|
-
## 🐛 Bug Fixes
|
|
16
|
-
|
|
17
|
-
- The experimental Vercel schedule provider bundles Schedules SDK alpha.19 and identifies eve to the Schedules API with an `x-vss-framework: eve` header. [#5528](https://github.com/vercel/eve/pull/5528)
|
|
18
|
-
|
|
19
|
-
- A file returned by a tool now becomes a "could not be stored" note when the session's sandbox rejects the write, instead of failing the step and replaying its model call and tools. [#4843](https://github.com/vercel/eve/pull/4843)
|
|
20
|
-
|
|
21
|
-
- A turn's principal no longer changes while it runs. [#4925](https://github.com/vercel/eve/pull/4925)
|
|
22
|
-
|
|
23
|
-
Only the turn's own principal can answer a pending `ctx.ask()` or `ask_question` by typing, whether a workflow tool, a subagent or a remote agent asked; another person's text waits and runs as their own turn instead of answering the question under the asker's auth. A typed answer updates the claims on `ctx.session.auth.current`, so its `delivery.consumed` hook and the rest of the turn see the request that sent it. Someone else's button answer still settles the request as its responder.
|
|
24
|
-
|
|
25
|
-
## Other Changes
|
|
26
|
-
|
|
27
|
-
See the [full list of changes](https://github.com/vercel/eve/compare/eve%400.85.0...eve%400.86.0).
|
|
28
|
-
|
|
29
|
-
## Contributors
|
|
30
|
-
|
|
31
|
-
- [@benpankow](https://github.com/benpankow)
|
|
32
|
-
- [@chadhietala](https://github.com/chadhietala)
|
|
33
|
-
- [@cmpadden](https://github.com/cmpadden)
|
|
34
|
-
- [@elliotdauber](https://github.com/elliotdauber)
|
|
35
|
-
- [@OwenKephart](https://github.com/OwenKephart)
|
|
36
|
-
- [@ruiconti](https://github.com/ruiconti)
|
|
37
|
-
|
|
38
|
-
For an upgrade across multiple releases, review each version between the installed and target versions in the [target version's changelog](https://raw.githubusercontent.com/vercel/eve/refs/tags/eve%400.86.0/packages/eve/CHANGELOG.md).
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
import{createLogger}from"#internal/logging.js";import{resolveDiscordBotToken}from"#public/channels/discord/api.js";import{DiscordGatewayFatalError,runGatewayConnection}from"#public/channels/discord/gateway/connection.js";import{vercelOidc}from"#public/agents/auth.js";import{createForwarder}from"#public/channels/discord/gateway/forwarder.js";const log=createLogger(`discord.gateway`);async function experimental_runDiscordGatewayRelay(e={}){let t=new URL(e.route??`/eve/v1/discord/gateway`,resolveBaseUrl(e.url)),n=e.signal===void 0?listenForShutdown():void 0,r=e.signal??n.signal,i=createForwarder({headers:outboundHeaders(e.auth),url:t});log.info(`Discord Gateway relay started`,{target:t.href});try{await runGatewayConnection({apiBaseUrl:e.api?.apiBaseUrl,fetch:e.api?.fetch,intents:4608|(e.messageContent===!0?32768:0),onDispatch:e=>{e.t===`MESSAGE_CREATE`&&i.enqueue(e)},resolveToken:()=>resolveDiscordBotToken(e.credentials?.botToken),signal:r})}finally{n?.dispose(),await i.drain(8e3)}}function resolveBaseUrl(e){if(e!==void 0)return new URL(e);let t=process.env.VERCEL_PROJECT_PRODUCTION_URL?.trim();if(t)return new URL(`https://${t}`);throw Error("experimental_runDiscordGatewayRelay needs the eve deployment's URL: pass `url`, such as http://localhost:2000 for eve dev, or run it where VERCEL_PROJECT_PRODUCTION_URL is set.")}function outboundHeaders(e){if(e!==void 0)return async()=>(await e()).headers;let t=vercelOidc(),n=!1;return async()=>{try{return(await t()).headers}catch(e){return n||(n=!0,log.warn(`No Vercel OIDC token; forwarding without credentials`,{error:e})),{}}}}function listenForShutdown(){let e=new AbortController,t=[`SIGTERM`,`SIGINT`],onSignal=t=>{log.info(`Discord Gateway relay shutting down`,{signal:t}),e.abort()};for(let e of t)process.once(e,onSignal);return{signal:e.signal,dispose:()=>{for(let e of t)process.off(e,onSignal)}}}export{DiscordGatewayFatalError,experimental_runDiscordGatewayRelay};
|