UNPKG

eve

Version:

Filesystem-first framework for durable backend AI agents that run anywhere.

github.com/vercel/eve

vercel/eve

224 lines (223 loc) • 17.1 kB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
/** Stable kind for an extension distribution compatibility manifest. */ export declare const EXTENSION_COMPATIBILITY_MANIFEST_KIND = "eve-extension"; /** Current compatibility-manifest JSON format. */ export declare const EXTENSION_COMPATIBILITY_MANIFEST_FORMAT_VERSION = 2; /** Filename emitted at the root of an extension's agent-shaped dist tree. */ export declare const EXTENSION_COMPATIBILITY_MANIFEST_FILENAME = "_manifest.json"; declare const EXTENSION_CAPABILITY_CONTRACTS: { readonly extension: { readonly current: 1; readonly supported: readonly [1]; readonly dropped: {}; }; readonly tool: { readonly current: 55; readonly supported: readonly [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 29, 30, 31, 32, 34, 35, 54, 55]; readonly dropped: { readonly 14: "TaskExec.delegated was removed; migrate to workflow-backed background tools"; readonly 15: "TaskExec replaces stageEffect with send"; readonly 16: "TaskExec.delegated was removed; migrate to workflow-backed background tools"; readonly 17: "TaskExec.delegated was removed; migrate to workflow-backed background tools"; readonly 18: "TaskExec.delegated was removed; migrate to workflow-backed background tools"; readonly 19: "TaskExec.delegated was removed; migrate to workflow-backed background tools"; readonly 20: "TaskExec.delegated was removed; migrate to workflow-backed background tools"; readonly 21: "TaskExec.delegated was removed; migrate to workflow-backed background tools"; readonly 22: "TaskExec.delegated was removed; migrate to workflow-backed background tools"; readonly 23: "TaskExec.delegated was removed; migrate to workflow-backed background tools"; readonly 24: "TaskExec.delegated was removed; migrate to workflow-backed background tools"; readonly 25: "TaskExec.delegated was removed; migrate to workflow-backed background tools"; readonly 26: "Background tools now use task yield descriptors"; readonly 27: "TaskExec.delegated was removed; migrate to workflow-backed background tools"; readonly 28: "Background defineTool and TaskExec were removed; use defineWorkflowTool for durable background work."; readonly 33: "ctx.agent now accepts the subagent name as its first argument, derives invocation identity internally, and infers structured output types"; readonly 36: "experimental_workflow and eve/tools/workflow were removed; migrate to the workflow factory from eve/tools/workflow"; readonly 37: "experimental_workflow and eve/tools/workflow were removed; migrate to the workflow factory from eve/tools/workflow"; readonly 38: "experimental_workflow and eve/tools/workflow were removed; migrate to the workflow factory from eve/tools/workflow"; readonly 39: "experimental_workflow and eve/tools/workflow were removed; migrate to the workflow factory from eve/tools/workflow"; readonly 40: "runWorkflowProgram was made internal; use the workflow factory from eve/tools/workflow"; readonly 41: "workflow no longer accepts agents and its options argument is optional; use workflow() or workflow({ maxSubagents })"; readonly 42: "Legacy session history migration was removed; user-role messages require current provenance kinds."; readonly 43: "Legacy session history migration was removed; user-role messages require current provenance kinds."; readonly 44: "Background defineTool and TaskExec were removed; use defineWorkflowTool for durable background work."; readonly 45: "Background defineTool and TaskExec were removed; use defineWorkflowTool for durable background work."; readonly 46: "Background defineTool and TaskExec were removed; use defineWorkflowTool for durable background work."; readonly 47: "eve/experimental/evaluate was removed; import evaluate from eve/ai"; readonly 48: "eve/experimental/evaluate was removed; import evaluate from eve/ai"; readonly 49: "Background defineTool and TaskExec were removed; use defineWorkflowTool for durable background work."; readonly 50: "Background defineTool and TaskExec were removed; use defineWorkflowTool for durable background work."; readonly 51: "Background defineTool and TaskExec were removed; use defineWorkflowTool for durable background work."; readonly 52: "Background defineTool and TaskExec were removed; use defineWorkflowTool for durable background work."; readonly 53: "Sandbox sessions no longer expose core identity and mutable networking is provider-specific."; }; }; readonly dynamicTool: { readonly current: 52; readonly supported: readonly [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 22, 31, 32, 33, 52]; readonly dropped: { readonly 21: "Message and reasoning append events now expose deltas instead of cumulative snapshots."; readonly 23: "TaskExec.delegated was removed; migrate to workflow-backed background tools"; readonly 24: "TaskExec.delegated was removed; migrate to workflow-backed background tools"; readonly 25: "TaskExec.delegated was removed; migrate to workflow-backed background tools"; readonly 26: "Background tools now use task yield descriptors"; readonly 27: "TaskExec.delegated was removed; migrate to workflow-backed background tools"; readonly 28: "Background dynamic tools were removed; use a static defineWorkflowTool for durable background work."; readonly 29: "Background dynamic tools were removed; use a static defineWorkflowTool for durable background work."; readonly 30: "Background dynamic tools were removed; use a static defineWorkflowTool for durable background work."; readonly 34: "Legacy session history migration was removed; user-role messages require current provenance kinds."; readonly 35: "workflowMaxSubagents was removed with experimental_workflow; configure generated-program limits with the workflow factory"; readonly 36: "workflowMaxSubagents was removed with experimental_workflow; configure generated-program limits with the workflow factory"; readonly 37: "workflowMaxSubagents was removed with experimental_workflow; configure generated-program limits with the workflow factory"; readonly 38: "workflowMaxSubagents was removed with experimental_workflow; configure generated-program limits with the workflow factory"; readonly 39: "Legacy session history migration was removed; user-role messages require current provenance kinds."; readonly 40: "Legacy session history migration was removed; user-role messages require current provenance kinds."; readonly 41: "Background dynamic tools were removed; use a static defineWorkflowTool for durable background work."; readonly 42: "autoModel and eve/experimental/evaluate were removed; import auto from eve/models"; readonly 43: "autoModel and eve/experimental/evaluate were removed; import auto from eve/models"; readonly 44: "autoModel and eve/experimental/evaluate were removed; import auto from eve/models"; readonly 45: "autoModel and eve/experimental/evaluate were removed; import auto from eve/models"; readonly 46: "autoModel and eve/experimental/evaluate were removed; import auto from eve/models"; readonly 47: "autoModel and eve/experimental/evaluate were removed; import auto from eve/models"; readonly 48: "Background dynamic tools were removed; use a static defineWorkflowTool for durable background work."; readonly 49: "Background dynamic tools were removed; use a static defineWorkflowTool for durable background work."; readonly 50: "Background dynamic tools were removed; use a static defineWorkflowTool for durable background work."; readonly 51: "Sandbox sessions no longer expose core identity and mutable networking is provider-specific."; }; }; readonly channel: { readonly current: 29; readonly supported: readonly [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 13, 14, 15, 16, 17, 18, 29]; readonly dropped: { readonly 12: "Message and reasoning append events now expose deltas instead of cumulative snapshots."; readonly 19: "Continuation rekey was removed; channel extensions must use additive continuation.alias instead."; readonly 20: "Continuation rekey was removed; channel extensions must use additive continuation.alias instead."; readonly 21: "Continuation rekey was removed; channel extensions must use additive continuation.alias instead."; readonly 22: "Continuation rekey was removed; channel extensions must use additive continuation.alias instead."; readonly 23: "Task views no longer expose executor bindings; background work is owned by workflow runs."; readonly 24: "Task views no longer expose executor bindings; background work is owned by workflow runs."; readonly 25: "Task views no longer expose executor bindings; background work is owned by workflow runs."; readonly 26: "Task views no longer expose executor bindings; background work is owned by workflow runs."; readonly 27: "Sandbox sessions no longer expose core identity and mutable networking is provider-specific."; readonly 28: "Sandbox sessions no longer expose core identity and mutable networking is provider-specific."; }; }; readonly schedule: { readonly current: 15; readonly supported: readonly [1, 2, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]; readonly dropped: { readonly 5: "Message and reasoning append events now expose deltas instead of cumulative snapshots."; }; }; readonly subagent: { readonly current: 19; readonly supported: readonly [3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 19]; readonly dropped: { readonly 1: "Persistent subagent sessions are now the default and the experimental opt-in was removed"; readonly 2: "Persistent subagent sessions are now the default and the experimental opt-in was removed"; readonly 5: "Message and reasoning append events now expose deltas instead of cumulative snapshots."; readonly 17: "Removed experimental.instrumentationProviders; instrumentation is now always enabled for root agents."; readonly 18: "Removed experimental.instrumentationProviders; instrumentation is now always enabled for root agents."; }; }; readonly connection: { readonly current: 24; readonly supported: readonly [1, 2, 3, 4, 5, 6, 7, 8, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 24]; readonly dropped: { readonly 9: "Dynamic connection resolvers no longer receive conversation or channel continuation data"; readonly 10: "Message and reasoning append events now expose deltas instead of cumulative snapshots."; readonly 23: "Sandbox sessions no longer expose core identity and mutable networking is provider-specific."; }; }; readonly hook: { readonly current: 25; readonly supported: readonly [10, 11, 12, 13, 14, 15, 17, 18, 19, 20, 21, 22, 23, 25]; readonly dropped: { readonly 1: "Model identity moved from session.started runtime metadata to step.started call attribution."; readonly 2: "Model identity moved from session.started runtime metadata to step.started call attribution."; readonly 3: "Model identity moved from session.started runtime metadata to step.started call attribution."; readonly 4: "Model identity moved from session.started runtime metadata to step.started call attribution."; readonly 5: "Model identity moved from session.started runtime metadata to step.started call attribution."; readonly 6: "Model identity moved from session.started runtime metadata to step.started call attribution."; readonly 7: "Model identity moved from session.started runtime metadata to step.started call attribution."; readonly 8: "Model identity moved from session.started runtime metadata to step.started call attribution."; readonly 9: "Model identity moved from session.started runtime metadata to step.started call attribution."; readonly 16: "Message and reasoning append events now expose deltas instead of cumulative snapshots."; readonly 24: "Sandbox sessions no longer expose core identity and mutable networking is provider-specific."; }; }; readonly skill: { readonly current: 1; readonly supported: readonly [1]; readonly dropped: {}; }; readonly dynamicSkill: { readonly current: 21; readonly supported: readonly [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 14, 15, 16, 17, 18, 19, 20, 21]; readonly dropped: { readonly 13: "Message and reasoning append events now expose deltas instead of cumulative snapshots."; }; }; readonly instructions: { readonly current: 2; readonly supported: readonly [1, 2]; readonly dropped: {}; }; readonly dynamicInstructions: { readonly current: 22; readonly supported: readonly [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 15, 16, 17, 18, 19, 20, 21, 22]; readonly dropped: { readonly 14: "Message and reasoning append events now expose deltas instead of cumulative snapshots."; }; }; readonly config: { readonly current: 1; readonly supported: readonly [1]; readonly dropped: {}; }; readonly state: { readonly current: 7; readonly supported: readonly [1, 2, 3, 4, 5, 7]; readonly dropped: { readonly 6: "Sandbox sessions no longer expose core identity and mutable networking is provider-specific."; }; }; }; /** One independently versioned extension-facing contract. */ export type ExtensionCapability = keyof typeof EXTENSION_CAPABILITY_CONTRACTS; /** Current producer contract version for each extension-facing capability. */ export declare const EXTENSION_CAPABILITY_VERSIONS: { readonly [TCapability in ExtensionCapability]: (typeof EXTENSION_CAPABILITY_CONTRACTS)[TCapability]["current"]; }; /** Capability requirements stamped by one extension build. */ export type ExtensionCapabilityRequirements = Partial<Record<ExtensionCapability, number>>; /** * Capability contract versions this eve release can consume. */ export declare const EXTENSION_CAPABILITY_SUPPORT: Readonly<Record<ExtensionCapability, readonly number[]>>; /** Consumer support table used to validate one extension distribution. */ export type ExtensionCapabilitySupport = Readonly<Record<string, readonly number[]>>; /** Compatibility-only metadata emitted by `eve extension build`. */ export interface ExtensionCompatibilityManifest { readonly kind: typeof EXTENSION_COMPATIBILITY_MANIFEST_KIND; readonly formatVersion: 1 | typeof EXTENSION_COMPATIBILITY_MANIFEST_FORMAT_VERSION; /** Diagnostic producer version; capability requirements decide compatibility. */ readonly builtWithEve: string; readonly requires: Readonly<Record<string, number>>; readonly build?: { readonly externalDependencies: readonly string[]; }; } /** One requirement the consuming eve cannot satisfy. */ export interface UnsupportedExtensionCapability { readonly capability: string; readonly requiredVersion: number; readonly supportedVersions: readonly number[]; } /** Serializes a compatibility manifest deterministically. */ export declare function serializeExtensionCompatibilityManifest(manifest: ExtensionCompatibilityManifest): string; /** Parses and validates compatibility-manifest JSON. */ export declare function parseExtensionCompatibilityManifest(raw: string, manifestPath: string): ExtensionCompatibilityManifest; /** Reads and validates an extension compatibility manifest. */ export declare function readExtensionCompatibilityManifest(manifestPath: string): Promise<ExtensionCompatibilityManifest>; /** Writes `_manifest.json` into an agent-shaped extension dist root. */ export declare function writeExtensionCompatibilityManifest(distRoot: string, manifest: ExtensionCompatibilityManifest): Promise<void>; /** Finds unknown or unsupported capability requirements without executing extension code. */ export declare function findUnsupportedExtensionCapabilities(manifest: ExtensionCompatibilityManifest, support?: ExtensionCapabilitySupport): UnsupportedExtensionCapability[]; export {};