eve 0.84.1 → 0.86.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.
Files changed (186) hide show
  1. package/README.md +7 -4
  2. package/dist/CHANGELOG.md +38 -0
  3. package/dist/src/channel/channel-operations.d.ts +2 -18
  4. package/dist/src/channel/compiled-channel.d.ts +3 -7
  5. package/dist/src/channel/cross-channel-receive.d.ts +9 -10
  6. package/dist/src/channel/cross-channel-receive.js +1 -1
  7. package/dist/src/channel/schedule.js +1 -1
  8. package/dist/src/channel/session.d.ts +26 -4
  9. package/dist/src/channel/session.js +1 -1
  10. package/dist/src/chunks/{use-eve-agent-DMeP0JOF.js → use-eve-agent-B2jCfcnG.js} +3 -2
  11. package/dist/src/chunks/{use-eve-agent-DP5Rso9C.js → use-eve-agent-DCLFi26P.js} +3 -2
  12. package/dist/src/cli/commands/agent-prompt/collect-intent.md +2 -1
  13. package/dist/src/cli/commands/agent-prompt/scaffold.md +1 -2
  14. package/dist/src/cli/dev/tui/runner.d.ts +1 -1
  15. package/dist/src/cli/dev/tui/runner.js +1 -1
  16. package/dist/src/cli/run.js +1 -1
  17. package/dist/src/client/client.js +1 -1
  18. package/dist/src/client/open-stream.js +1 -1
  19. package/dist/src/client/types.d.ts +5 -4
  20. package/dist/src/compiled/.vendor-stamp.json +4 -4
  21. package/dist/src/compiled/@vercel/schedules/index.d.ts +45 -6
  22. package/dist/src/compiled/@vercel/schedules/index.js +2 -2
  23. package/dist/src/context/keys.d.ts +7 -0
  24. package/dist/src/context/keys.js +1 -1
  25. package/dist/src/execution/agent-sessions/context.d.ts +5 -1
  26. package/dist/src/execution/agent-sessions/context.js +1 -1
  27. package/dist/src/execution/dynamic-workflow/tool.js +1 -1
  28. package/dist/src/execution/legacy-session/snapshot.d.ts +1 -2
  29. package/dist/src/execution/legacy-session/snapshot.js +1 -1
  30. package/dist/src/execution/proxied-deliver-step.js +1 -1
  31. package/dist/src/execution/public-destination.d.ts +3 -0
  32. package/dist/src/execution/public-destination.js +1 -1
  33. package/dist/src/execution/publish-session-events.js +1 -1
  34. package/dist/src/execution/session/active-turn.js +1 -1
  35. package/dist/src/execution/session/answer-caller.d.ts +9 -5
  36. package/dist/src/execution/session/answer-caller.js +1 -1
  37. package/dist/src/execution/session/checkpoint-migrations.d.ts +16 -5
  38. package/dist/src/execution/session/checkpoint-migrations.js +1 -1
  39. package/dist/src/execution/session/checkpoint-refusal.d.ts +4 -0
  40. package/dist/src/execution/session/checkpoint-refusal.js +1 -0
  41. package/dist/src/execution/session/entry.js +1 -1
  42. package/dist/src/execution/session/handoff-steps.d.ts +7 -1
  43. package/dist/src/execution/session/handoff-steps.js +1 -1
  44. package/dist/src/execution/session/imported-conversation.d.ts +2 -0
  45. package/dist/src/execution/session/imported-conversation.js +1 -0
  46. package/dist/src/execution/session/interrupted-step.js +1 -1
  47. package/dist/src/execution/session/pre-v27-checkpoint.d.ts +36 -0
  48. package/dist/src/execution/session/pre-v27-checkpoint.js +1 -0
  49. package/dist/src/execution/session/principal.d.ts +8 -0
  50. package/dist/src/execution/session/principal.js +1 -1
  51. package/dist/src/execution/session/program.d.ts +2 -0
  52. package/dist/src/execution/session/program.js +1 -1
  53. package/dist/src/execution/session/turn-step.js +1 -1
  54. package/dist/src/execution/session/turn.js +1 -1
  55. package/dist/src/execution/session-callback-request.js +1 -1
  56. package/dist/src/execution/tool-auth.js +1 -1
  57. package/dist/src/execution/tools/agent-router-workflow.js +1 -1
  58. package/dist/src/execution/tools/channel-to.d.ts +12 -0
  59. package/dist/src/execution/tools/channel-to.js +1 -0
  60. package/dist/src/execution/tools/workflow/body.d.ts +3 -0
  61. package/dist/src/execution/tools/workflow/body.js +1 -1
  62. package/dist/src/execution/tools/workflow/step-context.d.ts +5 -0
  63. package/dist/src/execution/tools/workflow/step-execution.js +1 -1
  64. package/dist/src/execution/tools/workflow/step.js +1 -1
  65. package/dist/src/execution/workflow-callback-url.d.ts +2 -3
  66. package/dist/src/execution/workflow-callback-url.js +1 -1
  67. package/dist/src/execution/workflow-runtime.js +1 -1
  68. package/dist/src/harness/attachment-staging.d.ts +2 -2
  69. package/dist/src/harness/attachment-staging.js +1 -1
  70. package/dist/src/harness/compaction/step.js +1 -1
  71. package/dist/src/harness/model-call/call.js +1 -1
  72. package/dist/src/harness/model-call/run.js +1 -1
  73. package/dist/src/harness/session-machine/transitions.js +1 -1
  74. package/dist/src/internal/application/stamped-package-version.js +1 -1
  75. package/dist/src/internal/attachments/limited-read.d.ts +2 -0
  76. package/dist/src/internal/attachments/limited-read.js +1 -1
  77. package/dist/src/internal/attachments/url-refs.js +1 -1
  78. package/dist/src/internal/capability-error.d.ts +3 -0
  79. package/dist/src/internal/capability-error.js +1 -0
  80. package/dist/src/internal/nitro/routes/schedule-collection-consumer.js +1 -1
  81. package/dist/src/public/channels/chat-sdk/chatSdkChannel.js +1 -1
  82. package/dist/src/public/channels/discord/discordChannel.js +1 -1
  83. package/dist/src/public/channels/github/githubChannel.js +1 -1
  84. package/dist/src/public/channels/linear/linearChannel.js +1 -1
  85. package/dist/src/public/channels/linq/inboundContent.js +1 -1
  86. package/dist/src/public/channels/slack/answers.d.ts +2 -3
  87. package/dist/src/public/channels/slack/answers.js +1 -1
  88. package/dist/src/public/channels/slack/api.d.ts +23 -3
  89. package/dist/src/public/channels/slack/api.js +1 -1
  90. package/dist/src/public/channels/slack/app-manifest.d.ts +2 -0
  91. package/dist/src/public/channels/slack/app-manifest.js +1 -1
  92. package/dist/src/public/channels/slack/auth.d.ts +2 -1
  93. package/dist/src/public/channels/slack/auth.js +1 -1
  94. package/dist/src/public/channels/slack/code-channel.d.ts +42 -0
  95. package/dist/src/public/channels/slack/code-channel.js +1 -0
  96. package/dist/src/public/channels/slack/defaults.d.ts +7 -3
  97. package/dist/src/public/channels/slack/defaults.js +3 -3
  98. package/dist/src/public/channels/slack/hitl.d.ts +7 -17
  99. package/dist/src/public/channels/slack/hitl.js +1 -1
  100. package/dist/src/public/channels/slack/index.d.ts +4 -3
  101. package/dist/src/public/channels/slack/index.js +1 -1
  102. package/dist/src/public/channels/slack/interaction-cards.d.ts +0 -2
  103. package/dist/src/public/channels/slack/interaction-cards.js +1 -1
  104. package/dist/src/public/channels/slack/interactions.js +1 -1
  105. package/dist/src/public/channels/slack/open-code-channel.d.ts +30 -0
  106. package/dist/src/public/channels/slack/open-code-channel.js +1 -0
  107. package/dist/src/public/channels/slack/private-approval-delivery.d.ts +16 -4
  108. package/dist/src/public/channels/slack/private-approval-delivery.js +1 -1
  109. package/dist/src/public/channels/slack/renderers.d.ts +58 -6
  110. package/dist/src/public/channels/slack/renderers.js +1 -1
  111. package/dist/src/public/channels/slack/reply-delivery.d.ts +4 -0
  112. package/dist/src/public/channels/slack/reply-delivery.js +1 -1
  113. package/dist/src/public/channels/slack/request-card-render.d.ts +45 -0
  114. package/dist/src/public/channels/slack/request-card-render.js +1 -0
  115. package/dist/src/public/channels/slack/request-cards.d.ts +35 -0
  116. package/dist/src/public/channels/slack/request-cards.js +3 -0
  117. package/dist/src/public/channels/slack/sign-in-cancel.d.ts +3 -5
  118. package/dist/src/public/channels/slack/sign-in-cancel.js +1 -1
  119. package/dist/src/public/channels/slack/slackChannel.d.ts +109 -22
  120. package/dist/src/public/channels/slack/slackChannel.js +1 -1
  121. package/dist/src/public/channels/slack/task-card.d.ts +3 -3
  122. package/dist/src/public/channels/slack/task-card.js +1 -1
  123. package/dist/src/public/channels/slack/thread-status.js +1 -1
  124. package/dist/src/public/channels/teams/api.js +1 -1
  125. package/dist/src/public/channels/teams/defaults.js +1 -1
  126. package/dist/src/public/channels/teams/teamsChannel.js +1 -1
  127. package/dist/src/public/channels/teams/verify.d.ts +9 -5
  128. package/dist/src/public/channels/teams/verify.js +1 -1
  129. package/dist/src/public/channels/telegram/telegramChannel.js +1 -1
  130. package/dist/src/public/channels/twilio/twilioChannel.js +1 -1
  131. package/dist/src/public/schedules/providers/vercel.d.ts +2 -0
  132. package/dist/src/public/schedules/providers/vercel.js +1 -1
  133. package/dist/src/public/schedules/subscription.d.ts +10 -1
  134. package/dist/src/runtime/subagents/workflow.js +1 -1
  135. package/dist/src/setup/index.d.ts +1 -1
  136. package/dist/src/setup/primitives/index.d.ts +1 -1
  137. package/dist/src/setup/primitives/pm/run.d.ts +0 -2
  138. package/dist/src/setup/scaffold/create/project.js +1 -1
  139. package/dist/src/shared/channel-definition.d.ts +4 -4
  140. package/dist/src/subagents/adapter.js +1 -1
  141. package/dist/src/subagents/parent-notification.js +1 -1
  142. package/dist/src/svelte/index.js +1 -1
  143. package/dist/src/svelte/use-eve-agent.js +1 -1
  144. package/dist/src/tools/definition.d.ts +21 -0
  145. package/dist/src/tools/provided/ask-question-workflow.js +1 -1
  146. package/dist/src/tools/provided/sleep-workflow.js +1 -1
  147. package/dist/src/tools/workflow-definition.d.ts +4 -4
  148. package/dist/src/vue/index.js +1 -1
  149. package/dist/src/vue/use-eve-agent.js +1 -1
  150. package/docs/channels/custom.mdx +16 -3
  151. package/docs/channels/eve.mdx +3 -5
  152. package/docs/channels/linq.mdx +1 -1
  153. package/docs/channels/slack.mdx +185 -18
  154. package/docs/channels/teams.mdx +6 -2
  155. package/docs/concepts/project-structure.mdx +1 -1
  156. package/docs/concepts/security-model.md +4 -0
  157. package/docs/concepts/upgrade-to-v27-events.md +70 -2
  158. package/docs/experimental/dynamic-schedules.mdx +2 -2
  159. package/docs/getting-started.mdx +2 -0
  160. package/docs/guides/auth-and-route-protection.md +1 -0
  161. package/docs/guides/client/overview.mdx +1 -1
  162. package/docs/guides/client/streaming.mdx +1 -1
  163. package/docs/guides/deployment/self-hosting.md +1 -1
  164. package/docs/guides/frontend/meta.json +1 -0
  165. package/docs/guides/frontend/nextjs.mdx +329 -121
  166. package/docs/guides/frontend/overview.mdx +115 -335
  167. package/docs/guides/frontend/tanstack.mdx +1 -1
  168. package/docs/guides/frontend/use-eve-agent-svelte.mdx +5 -5
  169. package/docs/guides/frontend/use-eve-agent-vue.mdx +5 -5
  170. package/docs/guides/frontend/use-eve-agent.mdx +385 -0
  171. package/docs/guides/hooks.md +1 -1
  172. package/docs/guides/remote-agents.md +10 -0
  173. package/docs/guides/self-modification.md +6 -0
  174. package/docs/patterns/fork-conversations-into-new-threads.md +159 -0
  175. package/docs/patterns/meta.json +1 -0
  176. package/docs/reference/cli.md +1 -2
  177. package/docs/sandbox/index.mdx +1 -1
  178. package/docs/schedules.mdx +1 -1
  179. package/docs/tools/overview.mdx +34 -0
  180. package/docs/tools/workflows.mdx +47 -5
  181. package/package.json +13 -21
  182. package/CHANGELOG.md +0 -3076
  183. package/dist/src/public/channels/slack/approval-cards.d.ts +0 -25
  184. package/dist/src/public/channels/slack/approval-cards.js +0 -2
  185. package/dist/src/self-modification/agent.d.ts +0 -12
  186. package/dist/src/self-modification/agent.js +0 -1
@@ -2,15 +2,29 @@ interface SchedulesApiClientOptions {
2
2
  baseUrl?: string;
3
3
  token?: string;
4
4
  fetch?: typeof fetch;
5
+ /**
6
+ * Headers sent with every request. They cannot replace the headers the
7
+ * client sets itself: `Authorization`, `Content-Type`, and `x-vss-client`.
8
+ */
9
+ headers?: HeadersInit;
10
+ }
11
+ interface SchedulesApiErrorOptions {
12
+ /** Machine-readable error code from the API, such as `not_found`. */
13
+ code?: string;
14
+ /** Seconds to wait before retrying, from the `Retry-After` header. */
15
+ retryAfter?: number;
5
16
  }
6
17
  declare class SchedulesApiError extends Error {
7
18
  readonly status: number;
8
- constructor(status: number, message: string);
19
+ readonly code?: string;
20
+ readonly retryAfter?: number;
21
+ constructor(status: number, message: string, options?: SchedulesApiErrorOptions);
9
22
  }
10
23
  declare class SchedulesApiClient {
11
24
  private readonly baseUrl?;
12
25
  private readonly token?;
13
26
  private readonly fetchImpl;
27
+ private readonly headers;
14
28
  private readonly configurationError?;
15
29
  constructor(options?: SchedulesApiClientOptions);
16
30
  protected getToken(): Promise<string>;
@@ -33,6 +47,13 @@ type ScheduleTarget = {
33
47
  } | {
34
48
  type: 'function';
35
49
  function: string;
50
+ /** Service the function belongs to; `function` is the path within it. */
51
+ service?: string;
52
+ } | {
53
+ type: 'path';
54
+ path: string;
55
+ /** HTTP method used to invoke the path. Dispatch defaults to `POST`. */
56
+ requestMethod?: 'GET' | 'POST';
36
57
  };
37
58
  type CreateScheduleTarget = {
38
59
  topic: string;
@@ -43,7 +64,6 @@ interface Schedule {
43
64
  scheduleId: string;
44
65
  ownerId: string;
45
66
  projectId: string;
46
- trackId: string;
47
67
  name: string;
48
68
  namespace: string;
49
69
  expression: ScheduleExpression;
@@ -52,6 +72,12 @@ interface Schedule {
52
72
  jitter?: number;
53
73
  target: ScheduleTarget;
54
74
  state: ScheduleState;
75
+ /**
76
+ * Unix ms when this schedule is disabled again, if it was enabled with
77
+ * `until`. Present only while `state` is `active` and the time is in the
78
+ * future.
79
+ */
80
+ activeUntil?: number;
55
81
  source: ScheduleSource;
56
82
  createdAt: number;
57
83
  updatedAt: number;
@@ -83,6 +109,16 @@ interface UpdateScheduleParams extends ScheduleIdentifier {
83
109
  payload?: unknown;
84
110
  }
85
111
  type UpdateScheduleResponse = Schedule;
112
+ interface EnableScheduleParams extends ScheduleIdentifier {
113
+ /**
114
+ * Enable the schedule only until this time (a `Date` or Unix ms), after
115
+ * which it is disabled again. Replaces the time on a schedule already
116
+ * enabled until one. Must be in the future, and a schedule already enabled
117
+ * without one is rejected with `schedule_already_active`. Omit to enable
118
+ * the schedule indefinitely, which also clears any existing time.
119
+ */
120
+ until?: Date | number;
121
+ }
86
122
  type InvokeScheduleParams = ScheduleIdentifier;
87
123
  interface ListSchedulesParams {
88
124
  namespace?: string;
@@ -100,7 +136,7 @@ declare class SchedulesClient extends SchedulesApiClient {
100
136
  get({ name, namespace }: ScheduleIdentifier): Promise<Schedule>;
101
137
  update({ name, namespace, target, ...params }: UpdateScheduleParams): Promise<UpdateScheduleResponse>;
102
138
  delete({ name, namespace }: ScheduleIdentifier): Promise<void>;
103
- enable({ name, namespace }: ScheduleIdentifier): Promise<Schedule>;
139
+ enable({ name, namespace, until }: EnableScheduleParams): Promise<Schedule>;
104
140
  disable({ name, namespace }: ScheduleIdentifier): Promise<Schedule>;
105
141
  invoke({ name, namespace }: InvokeScheduleParams): Promise<void>;
106
142
  }
@@ -118,6 +154,7 @@ declare const SCHEDULE_ID_HEADER = "ce-vssscheduleid";
118
154
  declare const SCHEDULE_NAME_HEADER = "ce-vssschedulename";
119
155
  declare const SCHEDULE_NAMESPACE_HEADER = "ce-vssnamespace";
120
156
  declare const SCHEDULE_SOURCE_HEADER = "ce-vssschedulesource";
157
+ declare const SCHEDULE_EXPRESSION_HEADER = "ce-vssexpression";
121
158
  interface ScheduleMetadata {
122
159
  /** Unique identifier of the schedule. */
123
160
  scheduleId: string;
@@ -134,8 +171,10 @@ interface ScheduleMetadata {
134
171
  scheduledAt: Date;
135
172
  /** How the schedule was defined, such as `static`. */
136
173
  source: string;
174
+ /** The schedule's cron expression, or the local datetime of a one-time schedule. */
175
+ expression: string;
137
176
  }
138
- type ScheduleHandler = (metadata: ScheduleMetadata) => void | Promise<void>;
177
+ type ScheduleHandler = (metadata: ScheduleMetadata, request: Request) => void | Promise<void>;
139
178
  declare class ScheduleEventParseError extends Error {
140
179
  cause?: unknown;
141
180
  constructor(message: string, options?: {
@@ -148,11 +187,11 @@ declare function parseScheduleEvent(request: Request): Promise<ScheduleMetadata>
148
187
  * Creates a web-standard route handler for schedule dispatches.
149
188
  *
150
189
  * ```ts
151
- * export const POST = handleSchedule(async (metadata) => {
190
+ * export const POST = handleSchedule(async (metadata, request) => {
152
191
  * console.log(metadata.name, metadata.scheduledAt);
153
192
  * });
154
193
  * ```
155
194
  */
156
195
  declare function handleSchedule(handler: ScheduleHandler): (request: Request) => Promise<Response>;
157
196
 
158
- export { CLOUD_EVENT_ID_HEADER, CLOUD_EVENT_SOURCE_HEADER, CLOUD_EVENT_SPEC_VERSION_HEADER, CLOUD_EVENT_TYPE_HEADER, type CreateScheduleParams, type CreateScheduleResponse, type CreateScheduleTarget, DEFAULT_SCHEDULES_BASE_URL, type InvokeScheduleParams, type ListSchedulesParams, type ListSchedulesResponse, SCHEDULE_CLOUD_EVENT_TYPE, SCHEDULE_ID_HEADER, SCHEDULE_NAMESPACE_HEADER, SCHEDULE_NAME_HEADER, SCHEDULE_SCHEDULED_AT_HEADER, SCHEDULE_SOURCE_HEADER, type Schedule, ScheduleEventParseError, type ScheduleExpression, type ScheduleHandler, type ScheduleIdentifier, type ScheduleMetadata, type ScheduleSource, type ScheduleState, type ScheduleTarget, schedules as Schedules, type SchedulesApiClientOptions, SchedulesApiError, SchedulesClient, type UpdateScheduleParams, type UpdateScheduleResponse, handleSchedule, parseScheduleEvent };
197
+ export { CLOUD_EVENT_ID_HEADER, CLOUD_EVENT_SOURCE_HEADER, CLOUD_EVENT_SPEC_VERSION_HEADER, CLOUD_EVENT_TYPE_HEADER, type CreateScheduleParams, type CreateScheduleResponse, type CreateScheduleTarget, DEFAULT_SCHEDULES_BASE_URL, type EnableScheduleParams, type InvokeScheduleParams, type ListSchedulesParams, type ListSchedulesResponse, SCHEDULE_CLOUD_EVENT_TYPE, SCHEDULE_EXPRESSION_HEADER, SCHEDULE_ID_HEADER, SCHEDULE_NAMESPACE_HEADER, SCHEDULE_NAME_HEADER, SCHEDULE_SCHEDULED_AT_HEADER, SCHEDULE_SOURCE_HEADER, type Schedule, ScheduleEventParseError, type ScheduleExpression, type ScheduleHandler, type ScheduleIdentifier, type ScheduleMetadata, type ScheduleSource, type ScheduleState, type ScheduleTarget, schedules as Schedules, type SchedulesApiClientOptions, SchedulesApiError, type SchedulesApiErrorOptions, SchedulesClient, type UpdateScheduleParams, type UpdateScheduleResponse, handleSchedule, parseScheduleEvent };