eve 0.52.4 → 0.52.5

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 (65) hide show
  1. package/CHANGELOG.md +14 -0
  2. package/dist/src/cli/commands/init-agent-workspace.d.ts +2 -0
  3. package/dist/src/cli/commands/init-agent-workspace.js +1 -1
  4. package/dist/src/cli/commands/init-install.d.ts +8 -0
  5. package/dist/src/cli/commands/init-install.js +1 -0
  6. package/dist/src/cli/commands/init.d.ts +3 -4
  7. package/dist/src/cli/commands/init.js +1 -1
  8. package/dist/src/cli/run.js +2 -2
  9. package/dist/src/cli/telemetry/index.d.ts +3 -0
  10. package/dist/src/cli/telemetry/index.js +1 -1
  11. package/dist/src/compiled/.vendor-stamp.json +3 -2
  12. package/dist/src/compiled/@workflow/world-local/index.js +1 -1
  13. package/dist/src/compiler/extension-compatibility.d.ts +2 -2
  14. package/dist/src/compiler/extension-compatibility.js +1 -1
  15. package/dist/src/context/dynamic-model-lifecycle.js +1 -1
  16. package/dist/src/context/keys.d.ts +11 -2
  17. package/dist/src/context/keys.js +1 -1
  18. package/dist/src/evals/mock-model.js +1 -1
  19. package/dist/src/evals/runner/run-evals.d.ts +1 -1
  20. package/dist/src/evals/runner/run-evals.js +1 -1
  21. package/dist/src/execution/activity-cohort.d.ts +20 -0
  22. package/dist/src/execution/activity-cohort.js +1 -0
  23. package/dist/src/execution/authorization-callback-match.d.ts +1 -0
  24. package/dist/src/execution/authorization-callback-match.js +1 -1
  25. package/dist/src/execution/parked-delivery-wait.js +1 -1
  26. package/dist/src/execution/session-activity-projection.d.ts +2 -0
  27. package/dist/src/execution/session-activity-projection.js +1 -1
  28. package/dist/src/execution/skills/instructions.js +1 -1
  29. package/dist/src/execution/tools/sleep-workflow.js +1 -1
  30. package/dist/src/execution/workflow-steps.js +1 -1
  31. package/dist/src/harness/approval-delivery-coordinator.js +1 -1
  32. package/dist/src/harness/authorization.d.ts +1 -0
  33. package/dist/src/harness/authorization.js +1 -1
  34. package/dist/src/harness/compaction.js +1 -1
  35. package/dist/src/harness/current-messages.d.ts +8 -2
  36. package/dist/src/harness/current-messages.js +1 -1
  37. package/dist/src/harness/hitl/approval-input-requests.js +1 -1
  38. package/dist/src/harness/input-requests.js +1 -1
  39. package/dist/src/harness/pending-input-batches.d.ts +4 -0
  40. package/dist/src/harness/pending-input-batches.js +1 -1
  41. package/dist/src/harness/tool-loop.js +2 -2
  42. package/dist/src/harness/turn-client-context.d.ts +1 -1
  43. package/dist/src/internal/application/package.js +1 -1
  44. package/dist/src/internal/mock-model-identity.d.ts +2 -0
  45. package/dist/src/internal/mock-model-identity.js +1 -0
  46. package/dist/src/internal/nitro/routes/agent-info/build-agent-info-response.js +1 -1
  47. package/dist/src/public/tools/index.d.ts +1 -0
  48. package/dist/src/public/tools/index.js +1 -1
  49. package/dist/src/setup/scaffold/create/project.js +1 -1
  50. package/dist/src/tasks/delivery-context.d.ts +2 -2
  51. package/dist/src/tasks/delivery-context.js +2 -18
  52. package/dist/src/tasks/delivery-policy.js +1 -1
  53. package/dist/src/tools/durable-callbacks.d.ts +18 -1
  54. package/dist/src/tools/durable-callbacks.js +1 -1
  55. package/docs/channels/overview.mdx +2 -0
  56. package/docs/channels/slack.mdx +2 -0
  57. package/docs/evals/running.mdx +3 -1
  58. package/docs/guides/dynamic-capabilities.md +36 -1
  59. package/docs/guides/instrumentation.md +3 -2
  60. package/docs/instructions.mdx +1 -1
  61. package/docs/reference/cli.md +1 -1
  62. package/docs/reference/telemetry.md +1 -1
  63. package/docs/reference/typescript-api.md +36 -35
  64. package/docs/tools/overview.mdx +4 -2
  65. package/package.json +1 -1
package/docs/reference/cli.md CHANGED
@@ -372,7 +372,7 @@ Runs all discovered evals when no eval ids are given; ids match exactly or by di
372
372
  | `--json` | flag | off | Output results as JSON |
373
373
  | `--junit <path>` | string | none | Write JUnit XML results to a file |
374
374
  | `--skip-report` | flag | off | Skip eval-defined reporters (e.g. Braintrust) |
375
- | `--verbose` | flag | off | Stream per-eval `t.log` lines to stdout |
375
+ | `--verbose` | flag | off | Stream per-eval logs and workflow run IDs to stdout |
376
376
 
377
377
  See [Evals](../evals/overview) for authoring evals.
378
378
 
package/docs/reference/telemetry.md CHANGED
@@ -12,7 +12,7 @@ eve collects usage data from its CLI to help improve its commands and developmen
12
12
  eve sends the following information to Vercel:
13
13
 
14
14
  - The eve version, operating system, CPU architecture, and whether stdin is a terminal.
15
- - The command you ran, its outcome, and setup or onboarding steps when applicable.
15
+ - The command you ran, its outcome, and setup or onboarding steps when applicable. When setup or onboarding fails, eve sends a bounded failure category such as target resolution, scaffolding, package-manager startup, workspace probing, dependency installation, Git initialization, handoff, or onboarding. It does not send the underlying error.
16
16
  - For `eve dev`, whether you connected to a local or remote agent and whether the UI was interactive or headless.
17
17
  - Random identifiers for the CLI session, installation, and project, plus whether the installation and project identifiers are ephemeral or persistent.
18
18
 
package/docs/reference/typescript-api.md CHANGED
@@ -34,6 +34,7 @@ export default defineTool({
34
34
  | ----------------------------------------------------- | ----------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ------------------------------------------------------ |
35
35
  | `defineAgent` | `eve` | `agent/agent.ts` | [agent.ts](../agent-config) |
36
36
  | `defineTool` | `eve/tools` | `agent/tools/<name>.ts` | [Tools](../tools) |
37
+ | `defineDurableCallback` | `eve/tools` | provider-package dynamic tool factories | [Dynamic capabilities](../guides/dynamic-capabilities) |
37
38
  | `defineWorkflowTool` | `eve/tools` | `agent/tools/<name>.ts` | [Workflow tools](../tools/workflows) |
38
39
  | `defineDynamic` | `eve`, `eve/tools`, `eve/skills`, `eve/instructions`, `eve/connections` | dynamic model or subagent `agent.ts`; `agent/{tools,skills,instructions,connections}/` | [Dynamic capabilities](../guides/dynamic-capabilities) |
39
40
  | `defineMcpClientConnection` | `eve/connections` | `agent/connections/<name>.ts` | [MCP connections](../connections/mcp) |
@@ -54,7 +55,7 @@ export default defineTool({
54
55
  | `mockModel` | `eve/evals` | Deterministic fixture agent models | [Evals](../evals/overview) |
55
56
  | `useEveAgent` | `eve/react`, `eve/vue`, `eve/svelte` | frontend | [Frontend](../guides/frontend/overview) |
56
57
 
57
- Tool-wide authoring helpers and types such as `defineTool`, `defineWorkflowTool`, `defineDynamic`, `disableTool`, and `ToolLabelDefinition` come from `eve/tools`. Capability-specific definitions and helpers use their own subpaths (see [Built-in tools](../concepts/built-in-tools)): reusable definitions such as `bash` and `glob` come from `eve/tools/<name>`, `webSearch` comes from `eve/tools/web_search`, `experimental_workflow` comes from `eve/tools/workflow`, `sleep` comes from `eve/tools/sleep`, and approval policies and types come from `eve/tools/approval`. The route verbs `GET`/`HEAD`/`POST`/`PUT`/`PATCH`/`DELETE`/`OPTIONS`/`WS` plus `disableRoute` come from `eve/channels`, and the channel auth helpers `localDev`/`vercelOidc`/`placeholderAuth` come from `eve/channels/auth`.
58
+ Tool-wide authoring helpers and types such as `defineTool`, `defineWorkflowTool`, `defineDurableCallback`, `defineDynamic`, `disableTool`, and `ToolLabelDefinition` come from `eve/tools`. Capability-specific definitions and helpers use their own subpaths (see [Built-in tools](../concepts/built-in-tools)): reusable definitions such as `bash` and `glob` come from `eve/tools/<name>`, `webSearch` comes from `eve/tools/web_search`, `experimental_workflow` comes from `eve/tools/workflow`, `sleep` comes from `eve/tools/sleep`, and approval policies and types come from `eve/tools/approval`. The route verbs `GET`/`HEAD`/`POST`/`PUT`/`PATCH`/`DELETE`/`OPTIONS`/`WS` plus `disableRoute` come from `eve/channels`, and the channel auth helpers `localDev`/`vercelOidc`/`placeholderAuth` come from `eve/channels/auth`.
58
59
 
59
60
  `AgentReasoningDefinition` is exported from `eve` for the top-level `defineAgent({ reasoning })` setting. `AgentLimitsDefinition` is exported for `defineAgent({ limits })`. `AgentWorkflowDefinition` and `AgentWorkflowWorldDefinition` are exported from `eve` for the `defineAgent({ experimental: { workflow } })` config shape. `ExperimentalWorkflowToolInput` is exported from `eve/tools/workflow`; `WebSearchToolInput` and `WebSearchProvider` are exported from `eve/tools/web_search`.
60
61
 
@@ -108,40 +109,40 @@ import template from "../../prompts/template.txt?raw";
108
109
 
109
110
  ## Imports at a glance
110
111
 
111
- | Import | Holds |
112
- | --------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
113
- | `eve` | `defineAgent`, `defineRemoteAgent`, `defineDynamic`, agent config types |
114
- | `eve/tools` | `defineTool`, `defineWorkflowTool`, `defineDynamic`, `disableTool`, generic tool types |
115
- | `eve/tools/{bash,read_file,write_file,todo,web_fetch,load_skill,glob,grep}` | Individual reusable tool definitions |
116
- | `eve/tools/approval` | Approval types and `always`, `once`, `never` |
117
- | `eve/tools/web_search` | Provider-managed `webSearch` configuration |
118
- | `eve/tools/workflow` | Experimental `Workflow` tool definition |
119
- | `eve/tools/sleep` | Opt-in durable `sleep` tool |
120
- | `eve/connections` | `defineMcpClientConnection`, `defineOpenAPIConnection`, `defineDynamic` |
121
- | `eve/channels` | `defineChannel`, `disableRoute`, route verbs |
122
- | `eve/channels/eve` | `eveChannel` |
123
- | `eve/channels/auth` | `localDev`, `vercelOidc`, `placeholderAuth` |
124
- | `eve/channels/{slack,discord,teams,telegram,twilio,github}` | platform channel factories |
125
- | `eve/hooks` | `defineHook` |
126
- | `eve/schedules` | `defineSchedule` |
127
- | `eve/skills` | `defineSkill`, `defineDynamic` |
128
- | `eve/instructions` | `defineInstructions`, `defineDynamic` |
129
- | `eve/memory` | `defineMemory`, `defineMemoryProvider`, provider and lifecycle types |
130
- | `eve/memory/scope` | `byPrincipal` and memory scope helpers |
131
- | `eve/memory/file` | `fileMemory`, `inMemory`, and the conditional document backend contract |
132
- | `eve/memory/file/vercel` | `vercelBlob` and Vercel Blob backend options |
133
- | `eve/context` | `defineState`, session and state types |
134
- | `eve/sandbox` | `defineSandbox`, backends |
135
- | `eve/instrumentation` | `defineInstrumentation`, `isChannel` |
136
- | `eve/local-dev` | `getLocalDevCapability`, `LocalDevCapability` |
137
- | `eve/models/openai` | `chatgpt`, deprecated `experimental_chatgpt` |
138
- | `eve/evals` | `defineEval`, `defineEvalConfig`, `mockModel`, eval types |
139
- | `eve/evals/expect` | `includes`, `equals`, `matches`, `similarity` |
140
- | `eve/evals/reporters` | `Braintrust`, `JUnit`, `EvalReporter` |
141
- | `eve/evals/loaders` | `loadJson`, `loadYaml` |
142
- | `eve/react`, `eve/vue`, `eve/svelte` | `useEveAgent` |
143
- | `eve/next`, `eve/nuxt`, `eve/sveltekit` | framework bundler plugins |
144
- | [`eve/client`](../guides/client/overview) | `Client`, `ClientSession`, health and agent-info schemas, response errors |
112
+ | Import | Holds |
113
+ | --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
114
+ | `eve` | `defineAgent`, `defineRemoteAgent`, `defineDynamic`, agent config types |
115
+ | `eve/tools` | `defineTool`, `defineWorkflowTool`, `defineDurableCallback`, `defineDynamic`, `disableTool`, tool types |
116
+ | `eve/tools/{bash,read_file,write_file,todo,web_fetch,load_skill,glob,grep}` | Individual reusable tool definitions |
117
+ | `eve/tools/approval` | Approval types and `always`, `once`, `never` |
118
+ | `eve/tools/web_search` | Provider-managed `webSearch` configuration |
119
+ | `eve/tools/workflow` | Experimental `Workflow` tool definition |
120
+ | `eve/tools/sleep` | Opt-in durable `sleep` tool |
121
+ | `eve/connections` | `defineMcpClientConnection`, `defineOpenAPIConnection`, `defineDynamic` |
122
+ | `eve/channels` | `defineChannel`, `disableRoute`, route verbs |
123
+ | `eve/channels/eve` | `eveChannel` |
124
+ | `eve/channels/auth` | `localDev`, `vercelOidc`, `placeholderAuth` |
125
+ | `eve/channels/{slack,discord,teams,telegram,twilio,github}` | platform channel factories |
126
+ | `eve/hooks` | `defineHook` |
127
+ | `eve/schedules` | `defineSchedule` |
128
+ | `eve/skills` | `defineSkill`, `defineDynamic` |
129
+ | `eve/instructions` | `defineInstructions`, `defineDynamic` |
130
+ | `eve/memory` | `defineMemory`, `defineMemoryProvider`, provider and lifecycle types |
131
+ | `eve/memory/scope` | `byPrincipal` and memory scope helpers |
132
+ | `eve/memory/file` | `fileMemory`, `inMemory`, and the conditional document backend contract |
133
+ | `eve/memory/file/vercel` | `vercelBlob` and Vercel Blob backend options |
134
+ | `eve/context` | `defineState`, session and state types |
135
+ | `eve/sandbox` | `defineSandbox`, backends |
136
+ | `eve/instrumentation` | `defineInstrumentation`, `isChannel` |
137
+ | `eve/local-dev` | `getLocalDevCapability`, `LocalDevCapability` |
138
+ | `eve/models/openai` | `chatgpt`, deprecated `experimental_chatgpt` |
139
+ | `eve/evals` | `defineEval`, `defineEvalConfig`, `mockModel`, eval types |
140
+ | `eve/evals/expect` | `includes`, `equals`, `matches`, `similarity` |
141
+ | `eve/evals/reporters` | `Braintrust`, `JUnit`, `EvalReporter` |
142
+ | `eve/evals/loaders` | `loadJson`, `loadYaml` |
143
+ | `eve/react`, `eve/vue`, `eve/svelte` | `useEveAgent` |
144
+ | `eve/next`, `eve/nuxt`, `eve/sveltekit` | framework bundler plugins |
145
+ | [`eve/client`](../guides/client/overview) | `Client`, `ClientSession`, health and agent-info schemas, response errors |
145
146
 
146
147
  Exported types ship from the same entrypoint as the helper they describe (for example `ToolDefinition` and `ToolContext` from `eve/tools`). The `exports` field in `packages/eve/package.json` lists every public entrypoint.
147
148
 
package/docs/tools/overview.mdx CHANGED
@@ -138,9 +138,11 @@ After the initiating turn accepts background tasks, eve supplies runtime-authore
138
138
  cohort and instructs the model to acknowledge that the work started without waiting for results.
139
139
  [Schedule](/docs/schedules)-initiated turns are the exception: no user prompted them, so their
140
140
  launches keep conditional delivery and send no acknowledgement.
141
- Later task-triggered parent turns receive fresh state for the same cohort. The model is instructed
142
- to keep related intermediate results silent while any task remains pending. Once every related
141
+ Later task-triggered parent turns receive fresh state for the same cohort. Once every related
143
142
  task is terminal, the state includes their outputs so the model can combine the useful results.
143
+ eve does not instruct the model to stay silent while sibling tasks are pending; a new user
144
+ question can receive an answer while background work continues. [Completion batching](/docs/subagents#completion-batching)
145
+ combines successful results already queued for the parent.
144
146
 
145
147
  ### Yield and return
146
148
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "eve",
3
- "version": "0.52.4",
3
+ "version": "0.52.5",
4
4
  "private": false,
5
5
  "description": "Filesystem-first framework for durable backend AI agents that run anywhere.",
6
6
  "keywords": [