UNPKG

eve

Version:

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

github.com/vercel/eve

vercel/eve

168 lines (167 loc) • 10 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
/** 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: 36; readonly supported: readonly [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 28, 29, 30, 31, 32, 34, 35, 36]; 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 33: "ctx.agent now accepts the subagent name as its first argument, derives invocation identity internally, and infers structured output types"; }; }; readonly dynamicTool: { readonly current: 34; readonly supported: readonly [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 22, 28, 29, 30, 31, 32, 33, 34]; 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 channel: { readonly current: 19; readonly supported: readonly [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 13, 14, 15, 16, 17, 18, 19]; readonly dropped: { readonly 12: "Message and reasoning append events now expose deltas instead of cumulative snapshots."; }; }; readonly schedule: { readonly current: 11; readonly supported: readonly [1, 2, 3, 4, 6, 7, 8, 9, 10, 11]; readonly dropped: { readonly 5: "Message and reasoning append events now expose deltas instead of cumulative snapshots."; }; }; readonly subagent: { readonly current: 13; readonly supported: readonly [3, 4, 6, 7, 8, 9, 10, 11, 12, 13]; 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 connection: { readonly current: 15; readonly supported: readonly [1, 2, 3, 4, 5, 6, 7, 8, 11, 12, 13, 14, 15]; 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 hook: { readonly current: 22; readonly supported: readonly [10, 11, 12, 13, 14, 15, 17, 18, 19, 20, 21, 22]; 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 skill: { readonly current: 1; readonly supported: readonly [1]; readonly dropped: {}; }; readonly dynamicSkill: { readonly current: 17; readonly supported: readonly [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 14, 15, 16, 17]; 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: 18; readonly supported: readonly [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 15, 16, 17, 18]; 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: 5; readonly supported: readonly [1, 2, 3, 4, 5]; readonly dropped: {}; }; }; /** 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 {};