@moinulmoin/eden-runtime-cloudflare 0.1.5 → 0.2.1

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 (47) hide show
  1. package/NOTICE +0 -31
  2. package/dist/eden-eve-host-worker.mjs +130 -10
  3. package/dist/eve-host-runtime.d.ts +13 -3
  4. package/dist/eve-host-runtime.js +47 -3
  5. package/dist/eve-host.d.ts +6 -1
  6. package/dist/eve-host.js +20 -11
  7. package/dist/index.d.ts +0 -18
  8. package/dist/index.js +0 -5
  9. package/package.json +2 -6
  10. package/dist/artifact-runtime.d.ts +0 -27
  11. package/dist/artifact-runtime.js +0 -14
  12. package/dist/http-host.d.ts +0 -6
  13. package/dist/http-host.js +0 -419
  14. package/dist/model-adapter-internal.d.ts +0 -12
  15. package/dist/model-adapter-internal.js +0 -172
  16. package/dist/model-adapter.d.ts +0 -9
  17. package/dist/model-adapter.js +0 -56
  18. package/dist/model-contracts.d.ts +0 -92
  19. package/dist/model-contracts.js +0 -2
  20. package/dist/model-normalizers.d.ts +0 -7
  21. package/dist/model-normalizers.js +0 -453
  22. package/dist/session-checkpoint.d.ts +0 -48
  23. package/dist/session-checkpoint.js +0 -300
  24. package/dist/session-identity.d.ts +0 -9
  25. package/dist/session-identity.js +0 -45
  26. package/dist/session-jobs.d.ts +0 -69
  27. package/dist/session-jobs.js +0 -427
  28. package/dist/session-journal.d.ts +0 -154
  29. package/dist/session-journal.js +0 -391
  30. package/dist/session-schema.d.ts +0 -21
  31. package/dist/session-schema.js +0 -247
  32. package/dist/session-state.d.ts +0 -165
  33. package/dist/session-state.js +0 -168
  34. package/dist/session.d.ts +0 -40
  35. package/dist/session.js +0 -792
  36. package/dist/test-execution.d.ts +0 -8
  37. package/dist/test-execution.js +0 -12
  38. package/dist/test-worker.d.ts +0 -12
  39. package/dist/test-worker.js +0 -214
  40. package/dist/tool-harness.d.ts +0 -31
  41. package/dist/tool-harness.js +0 -226
  42. package/dist/turn-runner-storage.d.ts +0 -28
  43. package/dist/turn-runner-storage.js +0 -583
  44. package/dist/turn-runner-types.d.ts +0 -112
  45. package/dist/turn-runner-types.js +0 -21
  46. package/dist/turn-runner.d.ts +0 -6
  47. package/dist/turn-runner.js +0 -370
@@ -1,300 +0,0 @@
1
- import { commitSessionTransaction, } from "./session-journal.js";
2
- export const MAX_CHECKPOINT_ATTEMPTS = 3;
3
- export function createStableEffectIdempotencyKey(identity) {
4
- const fields = [
5
- identity.sessionId,
6
- identity.turnId,
7
- identity.logicalStep,
8
- identity.callId,
9
- identity.toolName,
10
- identity.bundleIdentity,
11
- ];
12
- return `eden-effect-v1:${fields.map((field) => encodeURIComponent(field)).join(":")}`;
13
- }
14
- export const createEffectIdempotencyKey = createStableEffectIdempotencyKey;
15
- function now() {
16
- return new Date().toISOString();
17
- }
18
- function json(value) {
19
- const serialized = JSON.stringify(value);
20
- if (serialized === undefined) {
21
- throw new Error("Checkpoint values must be JSON-compatible");
22
- }
23
- return serialized;
24
- }
25
- function readStep(sql, request) {
26
- return sql
27
- .exec(`SELECT step_id, turn_id, logical_key, phase, status, attempt_count,
28
- result_ref
29
- FROM steps
30
- WHERE session_id = ? AND step_id = ?`, request.sessionId, request.stepId)
31
- .toArray()[0];
32
- }
33
- function readEffect(sql, request, idempotencyKey) {
34
- const byKey = sql
35
- .exec(`SELECT effect_id, turn_id, step_id, call_id, tool_name,
36
- idempotency_key, status, input_json, output_json
37
- FROM effects
38
- WHERE session_id = ? AND idempotency_key = ?`, request.sessionId, idempotencyKey)
39
- .toArray()[0];
40
- if (byKey !== undefined)
41
- return byKey;
42
- return sql
43
- .exec(`SELECT effect_id, turn_id, step_id, call_id, tool_name,
44
- idempotency_key, status, input_json, output_json
45
- FROM effects
46
- WHERE session_id = ? AND effect_id = ?`, request.sessionId, request.effectId)
47
- .toArray()[0];
48
- }
49
- function assertIdentity(request, idempotencyKey, step, effect) {
50
- if (step !== undefined &&
51
- (step.turn_id !== request.turnId ||
52
- step.logical_key !== request.logicalStep ||
53
- step.phase !== request.phase)) {
54
- throw new Error("Checkpoint step identity conflicts with durable state");
55
- }
56
- if (effect !== undefined &&
57
- (effect.effect_id !== request.effectId ||
58
- effect.turn_id !== request.turnId ||
59
- effect.step_id !== request.stepId ||
60
- effect.call_id !== request.callId ||
61
- effect.tool_name !== request.toolName ||
62
- effect.idempotency_key !== idempotencyKey ||
63
- effect.input_json !== json(request.input))) {
64
- throw new Error("Checkpoint effect identity conflicts with durable state");
65
- }
66
- }
67
- function readCompletedOutput(effect) {
68
- if (effect.output_json === null) {
69
- throw new Error("Completed checkpoint effect has no durable result");
70
- }
71
- return JSON.parse(effect.output_json);
72
- }
73
- export function prepareCheckpointAttempt(storage, request) {
74
- const idempotencyKey = createStableEffectIdempotencyKey(request);
75
- return commitSessionTransaction(storage, request.sessionId, (journal) => {
76
- const step = readStep(storage.sql, request);
77
- const effect = readEffect(storage.sql, request, idempotencyKey);
78
- assertIdentity(request, idempotencyKey, step, effect);
79
- if (effect?.status === "completed") {
80
- const output = readCompletedOutput(effect);
81
- if (step?.status !== "completed" || step.result_ref !== effect.effect_id) {
82
- const timestamp = now();
83
- journal.updateStep({
84
- stepId: request.stepId,
85
- status: "completed",
86
- resultRef: effect.effect_id,
87
- completedAt: timestamp,
88
- updatedAt: timestamp,
89
- });
90
- }
91
- return { status: "replayed", output };
92
- }
93
- if (effect?.status === "failed") {
94
- throw new Error("Checkpoint effect is durably failed");
95
- }
96
- if (step?.status === "failed") {
97
- throw new Error("Checkpoint step is durably failed");
98
- }
99
- if (step !== undefined && step.attempt_count >= MAX_CHECKPOINT_ATTEMPTS) {
100
- const timestamp = now();
101
- const errorId = `err_checkpoint_${request.stepId}`;
102
- const error = {
103
- code: "checkpoint_attempts_exhausted",
104
- message: "Checkpoint retry limit reached",
105
- retryable: false,
106
- };
107
- if (effect !== undefined) {
108
- journal.failEffect({
109
- effectId: request.effectId,
110
- error,
111
- updatedAt: timestamp,
112
- });
113
- }
114
- journal.updateStep({
115
- stepId: request.stepId,
116
- status: "failed",
117
- errorId,
118
- resultRef: null,
119
- updatedAt: timestamp,
120
- });
121
- journal.recordError({
122
- errorId,
123
- turnId: request.turnId,
124
- stepId: request.stepId,
125
- code: error.code,
126
- message: error.message,
127
- retryable: error.retryable,
128
- createdAt: timestamp,
129
- });
130
- journal.appendEvent({
131
- type: "step.failed",
132
- turnId: request.turnId,
133
- stepId: request.stepId,
134
- data: {
135
- stepId: request.stepId,
136
- code: error.code,
137
- message: error.message,
138
- retryable: error.retryable,
139
- },
140
- committedAt: timestamp,
141
- });
142
- return {
143
- status: "exhausted",
144
- attemptCount: step.attempt_count,
145
- };
146
- }
147
- const timestamp = now();
148
- const attemptCount = (step?.attempt_count ?? 0) + 1;
149
- if (step === undefined) {
150
- journal.insertStep({
151
- stepId: request.stepId,
152
- turnId: request.turnId,
153
- logicalKey: request.logicalStep,
154
- phase: request.phase,
155
- status: "running",
156
- attemptCount,
157
- createdAt: timestamp,
158
- updatedAt: timestamp,
159
- });
160
- }
161
- else {
162
- journal.updateStep({
163
- stepId: request.stepId,
164
- status: "running",
165
- attemptCount,
166
- errorId: null,
167
- updatedAt: timestamp,
168
- });
169
- }
170
- if (effect === undefined) {
171
- journal.requestEffect({
172
- effectId: request.effectId,
173
- turnId: request.turnId,
174
- stepId: request.stepId,
175
- callId: request.callId,
176
- toolName: request.toolName,
177
- idempotencyKey,
178
- input: request.input,
179
- createdAt: timestamp,
180
- });
181
- journal.startEffect({
182
- effectId: request.effectId,
183
- updatedAt: timestamp,
184
- });
185
- journal.appendEvent({
186
- type: "actions.requested",
187
- turnId: request.turnId,
188
- stepId: request.stepId,
189
- data: {
190
- stepId: request.stepId,
191
- actions: [
192
- {
193
- callId: request.callId,
194
- toolName: request.toolName,
195
- input: request.input,
196
- },
197
- ],
198
- },
199
- committedAt: timestamp,
200
- });
201
- }
202
- else {
203
- storage.sql.exec(`UPDATE effects
204
- SET status = 'running', updated_at = ?, error_json = NULL
205
- WHERE session_id = ? AND effect_id = ?
206
- AND status IN ('requested', 'running')`, timestamp, request.sessionId, request.effectId);
207
- }
208
- return {
209
- status: "execute",
210
- prepared: {
211
- request,
212
- idempotencyKey,
213
- attemptCount,
214
- },
215
- attemptCount,
216
- };
217
- });
218
- }
219
- export function commitCheckpointResult(storage, prepared, output, completedAt = now()) {
220
- return commitSessionTransaction(storage, prepared.request.sessionId, (journal) => {
221
- const step = readStep(storage.sql, prepared.request);
222
- const effect = readEffect(storage.sql, prepared.request, prepared.idempotencyKey);
223
- assertIdentity(prepared.request, prepared.idempotencyKey, step, effect);
224
- if (effect === undefined || step === undefined) {
225
- throw new Error("Checkpoint durable state is missing");
226
- }
227
- if (effect.status === "completed") {
228
- const existingOutput = readCompletedOutput(effect);
229
- return JSON.stringify(existingOutput) === JSON.stringify(output)
230
- ? { status: "replayed", output: existingOutput }
231
- : { status: "stale" };
232
- }
233
- if (step.attempt_count !== prepared.attemptCount ||
234
- step.status !== "running" ||
235
- effect.status !== "running") {
236
- return { status: "stale" };
237
- }
238
- journal.completeEffect({
239
- effectId: prepared.request.effectId,
240
- output,
241
- completedAt,
242
- });
243
- journal.updateStep({
244
- stepId: prepared.request.stepId,
245
- status: "completed",
246
- attemptCount: prepared.attemptCount,
247
- resultRef: prepared.request.effectId,
248
- completedAt,
249
- updatedAt: completedAt,
250
- });
251
- journal.appendEvent({
252
- type: "action.result",
253
- turnId: prepared.request.turnId,
254
- stepId: prepared.request.stepId,
255
- data: {
256
- stepId: prepared.request.stepId,
257
- callId: prepared.request.callId,
258
- toolName: prepared.request.toolName,
259
- output,
260
- },
261
- committedAt: completedAt,
262
- });
263
- return { status: "committed", output };
264
- });
265
- }
266
- export function markCheckpointRetryable(storage, prepared, updatedAt = now()) {
267
- return storage.transactionSync(() => {
268
- const step = readStep(storage.sql, prepared.request);
269
- const effect = readEffect(storage.sql, prepared.request, prepared.idempotencyKey);
270
- if (step === undefined ||
271
- effect === undefined ||
272
- effect.status === "completed" ||
273
- effect.status === "failed" ||
274
- step.attempt_count !== prepared.attemptCount ||
275
- step.status !== "running") {
276
- return false;
277
- }
278
- storage.sql.exec(`UPDATE steps
279
- SET status = 'retryable', updated_at = ?
280
- WHERE session_id = ? AND step_id = ? AND attempt_count = ?`, updatedAt, prepared.request.sessionId, prepared.request.stepId, prepared.attemptCount);
281
- return true;
282
- });
283
- }
284
- export async function reenterCheckpoint(storage, request, execute) {
285
- const prepared = prepareCheckpointAttempt(storage, request);
286
- if (prepared.status === "replayed")
287
- return prepared;
288
- if (prepared.status === "exhausted")
289
- return prepared;
290
- let output;
291
- try {
292
- output = await execute(prepared.prepared);
293
- }
294
- catch (error) {
295
- markCheckpointRetryable(storage, prepared.prepared);
296
- throw error;
297
- }
298
- return commitCheckpointResult(storage, prepared.prepared, output);
299
- }
300
- //# sourceMappingURL=session-checkpoint.js.map
@@ -1,9 +0,0 @@
1
- export declare function createOpaqueSessionId(): string;
2
- export declare function createOpaqueTurnId(): string;
3
- export declare function createOpaqueMessageId(): string;
4
- export declare function isOpaqueSessionId(value: string): boolean;
5
- export declare function isOpaqueTurnId(value: string): boolean;
6
- export declare function isOpaqueMessageId(value: string): boolean;
7
- export declare function createSessionObjectName(sessionId: string): string;
8
- export declare function sessionIdFromObjectName(objectName: string): string | null;
9
- //# sourceMappingURL=session-identity.d.ts.map
@@ -1,45 +0,0 @@
1
- const SESSION_ID_PATTERN = /^sess_[a-f0-9]{32}$/u;
2
- const TURN_ID_PATTERN = /^turn_[a-f0-9]{32}$/u;
3
- const MESSAGE_ID_PATTERN = /^msg_[a-f0-9]{32}$/u;
4
- const SESSION_OBJECT_PREFIX = "eden-session:";
5
- function randomOpaqueId(prefix) {
6
- const bytes = new Uint8Array(16);
7
- crypto.getRandomValues(bytes);
8
- let hex = "";
9
- for (const byte of bytes) {
10
- hex += byte.toString(16).padStart(2, "0");
11
- }
12
- return `${prefix}${hex}`;
13
- }
14
- export function createOpaqueSessionId() {
15
- return randomOpaqueId("sess_");
16
- }
17
- export function createOpaqueTurnId() {
18
- return randomOpaqueId("turn_");
19
- }
20
- export function createOpaqueMessageId() {
21
- return randomOpaqueId("msg_");
22
- }
23
- export function isOpaqueSessionId(value) {
24
- return SESSION_ID_PATTERN.test(value);
25
- }
26
- export function isOpaqueTurnId(value) {
27
- return TURN_ID_PATTERN.test(value);
28
- }
29
- export function isOpaqueMessageId(value) {
30
- return MESSAGE_ID_PATTERN.test(value);
31
- }
32
- export function createSessionObjectName(sessionId) {
33
- if (!isOpaqueSessionId(sessionId)) {
34
- throw new Error("Invalid opaque session identifier");
35
- }
36
- return `${SESSION_OBJECT_PREFIX}${sessionId}`;
37
- }
38
- export function sessionIdFromObjectName(objectName) {
39
- if (!objectName.startsWith(SESSION_OBJECT_PREFIX)) {
40
- return null;
41
- }
42
- const sessionId = objectName.slice(SESSION_OBJECT_PREFIX.length);
43
- return isOpaqueSessionId(sessionId) ? sessionId : null;
44
- }
45
- //# sourceMappingURL=session-identity.js.map
@@ -1,69 +0,0 @@
1
- import type { EdenSessionStorage, EdenSqlStorage } from "./session-journal.js";
2
- export declare const MAX_RECOVERY_JOBS_PER_ALARM = 4;
3
- export declare const MAX_RECOVERY_JOBS_PER_INSPECTION_PAGE = 32;
4
- export declare const MAX_RECOVERY_JOB_ATTEMPTS = 3;
5
- export declare const RECOVERY_RETRY_DELAY_MS = 1000;
6
- export declare const REGISTERED_RECOVERY_ACTIONS: readonly ["mark-complete", "always-fail", "fail", "run-bounded-turn"];
7
- export type RecoveryAction = (typeof REGISTERED_RECOVERY_ACTIONS)[number];
8
- export type RecoveryJobStatus = "pending" | "running" | "completed" | "retryable" | "dead";
9
- export interface RecoveryJobInput {
10
- readonly jobId: string;
11
- readonly kind: string;
12
- readonly dueAt: number;
13
- readonly maxAttempts?: number;
14
- readonly recoveryAction: string;
15
- readonly createdAt?: string;
16
- }
17
- export interface RecoveryJobRecord {
18
- readonly jobId: string;
19
- readonly kind: string;
20
- readonly status: RecoveryJobStatus;
21
- readonly dueAt: number;
22
- readonly attempts: number;
23
- readonly maxAttempts: number;
24
- readonly lastError: string | null;
25
- readonly recoveryAction: string | null;
26
- readonly createdAt: string;
27
- readonly updatedAt: string;
28
- readonly completedAt: string | null;
29
- }
30
- export interface RecoveryJobInspection {
31
- readonly jobs: readonly RecoveryJobRecord[];
32
- readonly nextDueAt: number | null;
33
- readonly nextCursor: string | null;
34
- }
35
- export interface RecoveryJobInspectionOptions {
36
- readonly cursor?: string;
37
- readonly limit?: number;
38
- }
39
- export type RecoveryJobEnqueueResult = {
40
- readonly status: "scheduled";
41
- readonly job: RecoveryJobRecord;
42
- } | {
43
- readonly status: "deduplicated";
44
- readonly job: RecoveryJobRecord;
45
- };
46
- export type RecoveryJobRecoveryResult = {
47
- readonly status: "scheduled";
48
- readonly job: RecoveryJobRecord;
49
- };
50
- export type RecoveryJobStorage = EdenSessionStorage;
51
- export interface RecoveryJobExecutionOptions {
52
- readonly now?: number;
53
- readonly limit?: number;
54
- }
55
- export interface RecoveryJobProcessingResult {
56
- readonly processed: number;
57
- readonly completed: number;
58
- readonly retryable: number;
59
- readonly dead: number;
60
- }
61
- export declare function isRegisteredRecoveryAction(action: string | null | undefined): action is RecoveryAction;
62
- export declare function quarantineLegacyCompletedUnknownActions(storage: RecoveryJobStorage, sessionId: string): void;
63
- export declare function sanitizeRecoveryError(error: unknown): string;
64
- export declare function inspectRecoveryJobs(storage: RecoveryJobStorage, sessionId: string, options?: RecoveryJobInspectionOptions): RecoveryJobInspection;
65
- export declare function enqueueRecoveryJob(storage: RecoveryJobStorage, sessionId: string, input: RecoveryJobInput): RecoveryJobEnqueueResult;
66
- export declare function recoverRecoveryJob(storage: RecoveryJobStorage, sessionId: string, jobId: string, recoveryAction?: string, dueAt?: number): RecoveryJobRecoveryResult;
67
- export declare function processRecoveryJobs(storage: RecoveryJobStorage, sessionId: string, execute: (job: RecoveryJobRecord) => void | Promise<void>, options?: RecoveryJobExecutionOptions): Promise<RecoveryJobProcessingResult>;
68
- export declare function nextRecoveryJobDueAt(sql: EdenSqlStorage, sessionId: string): number | null;
69
- //# sourceMappingURL=session-jobs.d.ts.map