@effect-agent/storage-sqlite 0.1.0-beta.6 → 0.1.0-beta.60

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 (59) hide show
  1. package/dist/SqliteActivityStore.d.mts +14 -0
  2. package/dist/SqliteActivityStore.mjs +310 -0
  3. package/dist/SqliteActivityStore.mjs.map +1 -0
  4. package/dist/SqliteMessageDeliveryStore.d.mts +14 -0
  5. package/dist/SqliteMessageDeliveryStore.mjs +24 -0
  6. package/dist/SqliteMessageDeliveryStore.mjs.map +1 -0
  7. package/dist/SqliteScheduleStore.d.mts +14 -0
  8. package/dist/SqliteScheduleStore.mjs +255 -0
  9. package/dist/SqliteScheduleStore.mjs.map +1 -0
  10. package/dist/SqliteStorageConfig.d.mts +34 -0
  11. package/dist/SqliteStorageConfig.mjs +39 -0
  12. package/dist/SqliteStorageConfig.mjs.map +1 -0
  13. package/dist/SqliteStorageError-CzKmwCLl.d.mts +86 -0
  14. package/dist/SqliteStorageError.d.mts +2 -0
  15. package/dist/SqliteStorageError.mjs +148 -0
  16. package/dist/SqliteStorageError.mjs.map +1 -0
  17. package/dist/SqliteStorageFailpoint.d.mts +17 -0
  18. package/dist/SqliteStorageFailpoint.mjs +14 -0
  19. package/dist/SqliteStorageFailpoint.mjs.map +1 -0
  20. package/dist/SqliteStorageFailpointTesting.d.mts +15 -0
  21. package/dist/SqliteStorageFailpointTesting.mjs +19 -0
  22. package/dist/SqliteStorageFailpointTesting.mjs.map +1 -0
  23. package/dist/SqliteStorageVersion-gA7_96xM.d.mts +9 -0
  24. package/dist/SqliteStorageVersion.d.mts +2 -0
  25. package/dist/SqliteStorageVersion.mjs +8 -0
  26. package/dist/SqliteStorageVersion.mjs.map +1 -0
  27. package/dist/SqliteSubmissionLedger.d.mts +23 -0
  28. package/dist/SqliteSubmissionLedger.mjs +1765 -0
  29. package/dist/SqliteSubmissionLedger.mjs.map +1 -0
  30. package/dist/SqliteSubscriptionStore.d.mts +13 -0
  31. package/dist/SqliteSubscriptionStore.mjs +28 -0
  32. package/dist/SqliteSubscriptionStore.mjs.map +1 -0
  33. package/dist/SqliteThreadStore.d.mts +49 -0
  34. package/dist/SqliteThreadStore.mjs +427 -0
  35. package/dist/SqliteThreadStore.mjs.map +1 -0
  36. package/dist/index.d.mts +11 -193
  37. package/dist/index.mjs +11 -3082
  38. package/dist/migrations-dnTR0RKq.mjs +326 -0
  39. package/dist/migrations-dnTR0RKq.mjs.map +1 -0
  40. package/dist/rolldown-runtime-D7D4PA-g.mjs +13 -0
  41. package/dist/sqlite-journal-lDduEakl.mjs +887 -0
  42. package/dist/sqlite-journal-lDduEakl.mjs.map +1 -0
  43. package/package.json +1 -41
  44. package/src/SqliteActivityStore.ts +556 -0
  45. package/src/SqliteMessageDeliveryStore.ts +42 -0
  46. package/src/SqliteScheduleStore.ts +404 -0
  47. package/src/{sqlite-storage-config.ts → SqliteStorageConfig.ts} +1 -1
  48. package/src/{errors.ts → SqliteStorageError.ts} +8 -3
  49. package/src/SqliteStorageFailpoint.ts +23 -0
  50. package/src/{sqlite-storage-failpoint.ts → SqliteStorageFailpointTesting.ts} +7 -18
  51. package/src/SqliteStorageVersion.ts +2 -0
  52. package/src/{sqlite-ledger.ts → SqliteSubmissionLedger.ts} +753 -118
  53. package/src/SqliteSubscriptionStore.ts +59 -0
  54. package/src/{sqlite-conversation-store.ts → SqliteThreadStore.ts} +372 -302
  55. package/src/index.ts +10 -6
  56. package/src/internal/message-delivery-schema.ts +24 -0
  57. package/src/{migrations.ts → internal/migrations.ts} +145 -79
  58. package/src/{sqlite-journal.ts → internal/sqlite-journal.ts} +534 -222
  59. package/dist/index.mjs.map +0 -1
@@ -0,0 +1,1765 @@
1
+ import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
2
+ import { SqliteStorageConfig } from "./SqliteStorageConfig.mjs";
3
+ import { SqliteLedgerError, SqliteStorageCorruptionError, SqliteStorageError, SqliteWriteContention } from "./SqliteStorageError.mjs";
4
+ import { SqliteStorageFailpoint } from "./SqliteStorageFailpoint.mjs";
5
+ import { a as initializeSqliteJournal, i as decodeRows } from "./sqlite-journal-lDduEakl.mjs";
6
+ import { storageConfigLayer, storageFailpointLayer } from "./SqliteThreadStore.mjs";
7
+ import { Clock, Context, Crypto, DateTime, Effect, Layer, Option, Schema, Stream } from "effect";
8
+ import * as SqlClientService from "effect/unstable/sql/SqlClient";
9
+ import { ApprovalDecision, CanonicalSequence, DefinitionDigests, Digest, PersistedJson, ProducerEpoch, RecordEnvelope, SettlementOutcome, WorkerAdmission } from "@effect-agent/thread/Records";
10
+ import { NodeCrypto } from "@effect/platform-node";
11
+ import { SqliteClient } from "@effect/sql-sqlite-node";
12
+ import { MessageAdmission } from "@effect-agent/core/Messaging";
13
+ import { EMPTY_TAIL_DIGEST } from "@effect-agent/thread/Digest";
14
+ import { AbortCommand, AbortIntent, AbortIntentRequest, AdmissionAdmitted, AdmissionConflict, AdmissionFence, AdmissionGroup, AdmissionNotAdmitted, AdmissionPolicyError, AdmissionRequest, AdmissionResult, ApprovalConflict, ApprovalDecisionCommand, ApprovalDecisionIntent, AttachChildToReservationRequest, BeginChildBudgetReleaseRequest, ChildAttachmentSnapshot, ChildBudgetReservationRequest, ChildBudgetReservationSnapshot, ChildReservationConflict, ChildReservationStatus, ChildSettledNotification, Claim, ClaimJoiningRequest, ClaimRequest, InputAppliedMarker, JoinSnapshot, JoinedToHost, JoiningClaim, LedgerCapabilities, LedgerError, MarkInputAppliedRequest, MarkJoinedRequest, MarkReadyRequest, MarkUnknownRequest, OwnershipLost, OwnershipRenewal, OwnershipSnapshot, ParentLinkage, QueueSequence, RecoverySnapshot, RecoverySnapshotRequest, ReleaseChildBudgetRequest, ReleaseOwnershipRequest, RenewOwnershipRequest, ReservedChildBudget, ReservedSettlement, RevertJoiningRequest, Settlement, SettlementConflict, SettlementFinalization, SettlementReservation, SettlementReservationSnapshot, SubmissionAdmissionFence, SubmissionLedger, SubmissionLookup, SubmissionLookupByKey, SubmissionSnapshot, SubmissionState, SuspendRequest, SuspensionReason, SuspensionSnapshot, UnknownResolution, UnknownResolutionCommand, UnknownResolutionConflict, UnknownResolutionIntent, settlementFailureFromRecord, submissionAbortRecordId } from "@effect-agent/thread/SubmissionLedger";
15
+ //#region src/SqliteSubmissionLedger.ts
16
+ var SqliteSubmissionLedger_exports = /* @__PURE__ */ __exportAll({
17
+ ledgerLayer: () => ledgerLayer,
18
+ submissionLedgerLayer: () => submissionLedgerLayer
19
+ });
20
+ const BoundedStoredText = Schema.String.check(Schema.isMaxLength(16777216));
21
+ const BoundedIdentifier = Schema.NonEmptyString.check(Schema.isMaxLength(1024));
22
+ const BoundedTimestamp = Schema.NonEmptyString.check(Schema.isMaxLength(128));
23
+ const SCAN_PAGE_SIZE = 256;
24
+ const EPOCH_ZERO = Schema.decodeSync(ProducerEpoch)(0);
25
+ const RESUME_IMMEDIATELY = "resume-immediately";
26
+ const SUSPENDED = "suspended";
27
+ const NOT_WAITING = "not-waiting";
28
+ const STILL_WAITING = "still-waiting";
29
+ const WOKEN = "woken";
30
+ var SubmissionRow = class extends Schema.Class("SubmissionRow")({
31
+ submission_id: BoundedIdentifier,
32
+ thread_id: BoundedIdentifier,
33
+ queue_sequence: QueueSequence,
34
+ principal: BoundedIdentifier,
35
+ idempotency_key: BoundedIdentifier,
36
+ agent_id: BoundedIdentifier,
37
+ agent_digests_json: BoundedStoredText,
38
+ deployment_id: BoundedIdentifier,
39
+ input_json: BoundedStoredText,
40
+ input_digest: Digest,
41
+ receipt_id: BoundedIdentifier,
42
+ state: SubmissionState,
43
+ settled_outcome: Schema.NullOr(SettlementOutcome),
44
+ created_at: BoundedTimestamp,
45
+ ready_at: Schema.NullOr(BoundedTimestamp),
46
+ input_applied_record_id: Schema.NullOr(BoundedIdentifier),
47
+ input_applied_sequence: Schema.NullOr(CanonicalSequence),
48
+ joined_host_submission_id: Schema.NullOr(BoundedIdentifier),
49
+ suspended_reason_json: Schema.NullOr(BoundedStoredText),
50
+ suspended_at: Schema.NullOr(BoundedTimestamp),
51
+ unknown_reason: Schema.NullOr(BoundedStoredText),
52
+ unknown_tool_call_ids_json: Schema.NullOr(BoundedStoredText),
53
+ parent_submission_id: Schema.NullOr(BoundedIdentifier),
54
+ parent_tool_call_id: Schema.NullOr(BoundedIdentifier),
55
+ admission_group: Schema.NullOr(AdmissionGroup),
56
+ admission_fence_json: Schema.NullOr(BoundedStoredText),
57
+ worker_admission_json: Schema.NullOr(BoundedStoredText),
58
+ message_admission_json: Schema.NullOr(BoundedStoredText)
59
+ }) {};
60
+ var ChildReservationRow = class extends Schema.Class("ChildReservationRow")({
61
+ reservation_id: BoundedIdentifier,
62
+ parent_submission_id: BoundedIdentifier,
63
+ parent_tool_call_id: BoundedIdentifier,
64
+ child_submission_id: Schema.NullOr(BoundedIdentifier),
65
+ status: ChildReservationStatus,
66
+ allocation_json: BoundedStoredText,
67
+ allocation_digest: Digest,
68
+ accounting_json: Schema.NullOr(BoundedStoredText),
69
+ reserved_at: BoundedTimestamp,
70
+ release_began_at: Schema.NullOr(BoundedTimestamp),
71
+ released_at: Schema.NullOr(BoundedTimestamp)
72
+ }) {};
73
+ var ApprovalDecisionRow = class extends Schema.Class("ApprovalDecisionRow")({
74
+ submission_id: BoundedIdentifier,
75
+ tool_call_id: BoundedIdentifier,
76
+ decision: ApprovalDecision,
77
+ resolver: BoundedIdentifier,
78
+ reason: BoundedStoredText,
79
+ decided_at: BoundedTimestamp
80
+ }) {};
81
+ var UnknownResolutionRow = class extends Schema.Class("UnknownResolutionRow")({
82
+ submission_id: BoundedIdentifier,
83
+ tool_call_id: BoundedIdentifier,
84
+ author: BoundedIdentifier,
85
+ reason: BoundedStoredText,
86
+ resolution_json: BoundedStoredText,
87
+ resolved_at: BoundedTimestamp
88
+ }) {};
89
+ var OwnershipRow = class extends Schema.Class("OwnershipRow")({
90
+ submission_id: BoundedIdentifier,
91
+ attempt_id: BoundedIdentifier,
92
+ ownership_token: BoundedIdentifier,
93
+ producer_epoch: ProducerEpoch,
94
+ owner_producer_id: BoundedIdentifier,
95
+ lease_expires_at: BoundedTimestamp
96
+ }) {};
97
+ var ReservationRow = class extends Schema.Class("ReservationRow")({
98
+ submission_id: BoundedIdentifier,
99
+ settlement_id: BoundedIdentifier,
100
+ outcome: SettlementOutcome,
101
+ record_id: BoundedIdentifier,
102
+ record_json: BoundedStoredText,
103
+ record_digest: Digest,
104
+ reserved_at: BoundedTimestamp,
105
+ finalized_at: Schema.NullOr(BoundedTimestamp)
106
+ }) {};
107
+ var AbortIntentRow = class extends Schema.Class("AbortIntentRow")({
108
+ submission_id: BoundedIdentifier,
109
+ author: BoundedIdentifier,
110
+ reason: BoundedStoredText,
111
+ requested_at: BoundedTimestamp,
112
+ canonical_record_id: Schema.NullOr(BoundedIdentifier)
113
+ }) {};
114
+ var MaxQueueSequenceRow = class extends Schema.Class("MaxQueueSequenceRow")({ max_queue_sequence: Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)) }) {};
115
+ var AbortIntentLookupRow = class extends Schema.Class("AbortIntentLookupRow")({
116
+ submission_id: BoundedIdentifier,
117
+ abort_submission_id: Schema.NullOr(BoundedIdentifier),
118
+ author: Schema.NullOr(BoundedIdentifier),
119
+ reason: Schema.NullOr(BoundedStoredText),
120
+ requested_at: Schema.NullOr(BoundedTimestamp),
121
+ canonical_record_id: Schema.NullOr(BoundedIdentifier)
122
+ }) {};
123
+ var CanonicalRecordIdRow = class extends Schema.Class("CanonicalRecordIdRow")({ record_id: BoundedIdentifier }) {};
124
+ const SUBMISSION_COLUMNS = `
125
+ submission_id,
126
+ thread_id,
127
+ queue_sequence,
128
+ principal,
129
+ idempotency_key,
130
+ agent_id,
131
+ agent_digests_json,
132
+ deployment_id,
133
+ input_json,
134
+ input_digest,
135
+ receipt_id,
136
+ state,
137
+ settled_outcome,
138
+ created_at,
139
+ ready_at,
140
+ input_applied_record_id,
141
+ input_applied_sequence,
142
+ joined_host_submission_id,
143
+ suspended_reason_json,
144
+ suspended_at,
145
+ unknown_reason,
146
+ unknown_tool_call_ids_json,
147
+ parent_submission_id,
148
+ parent_tool_call_id,
149
+ admission_group,
150
+ admission_fence_json,
151
+ worker_admission_json,
152
+ message_admission_json
153
+ `;
154
+ const CHILD_RESERVATION_COLUMNS = `
155
+ reservation_id,
156
+ parent_submission_id,
157
+ parent_tool_call_id,
158
+ child_submission_id,
159
+ status,
160
+ allocation_json,
161
+ allocation_digest,
162
+ accounting_json,
163
+ reserved_at,
164
+ release_began_at,
165
+ released_at
166
+ `;
167
+ /** The branded ToolCallId schema, reached through the thread port so no core import is needed. */
168
+ const ToolCallIdSchema = ApprovalDecisionCommand.fields.toolCallId;
169
+ const ToolCallIdList = Schema.Array(ToolCallIdSchema);
170
+ const encodePersistedJsonText = Schema.encodeEffect(Schema.fromJsonString(PersistedJson));
171
+ const encodeDefinitionDigestsText = Schema.encodeEffect(Schema.fromJsonString(DefinitionDigests));
172
+ const encodeRecordEnvelopeText = Schema.encodeEffect(Schema.fromJsonString(RecordEnvelope));
173
+ const decodeRecordEnvelopeText = Schema.decodeEffect(Schema.fromJsonString(RecordEnvelope));
174
+ const encodeSuspensionReasonText = Schema.encodeEffect(Schema.fromJsonString(SuspensionReason));
175
+ const encodeUnknownResolutionText = Schema.encodeEffect(Schema.fromJsonString(UnknownResolution));
176
+ const encodeToolCallIdsText = Schema.encodeEffect(Schema.fromJsonString(ToolCallIdList));
177
+ const decodeToolCallIdsText = Schema.decodeEffect(Schema.fromJsonString(ToolCallIdList));
178
+ const parseStoredJsonText = Schema.decodeEffect(Schema.fromJsonString(Schema.Json));
179
+ const decodeAdmissionResult = Schema.decodeUnknownEffect(AdmissionResult);
180
+ const decodeClaim = Schema.decodeUnknownEffect(Claim);
181
+ const decodeOwnershipRenewal = Schema.decodeUnknownEffect(OwnershipRenewal);
182
+ const decodeSettlement = Schema.decodeUnknownEffect(Settlement);
183
+ const decodeAbortIntent = Schema.decodeUnknownEffect(AbortIntent);
184
+ const decodeOwnershipSnapshot = Schema.decodeUnknownEffect(OwnershipSnapshot);
185
+ const decodeInputAppliedMarker = Schema.decodeUnknownEffect(InputAppliedMarker);
186
+ const decodeSubmissionSnapshotUnknown = Schema.decodeUnknownEffect(SubmissionSnapshot);
187
+ const decodeSubmissionId = Schema.decodeUnknownEffect(SubmissionSnapshot.fields.submissionId);
188
+ const decodeQueueSequence = Schema.decodeUnknownEffect(QueueSequence);
189
+ const decodeUtcInstant = Schema.decodeUnknownEffect(Schema.DateTimeUtcFromString);
190
+ const decodeJoiningClaim = Schema.decodeUnknownEffect(JoiningClaim);
191
+ const decodeJoinSnapshot = Schema.decodeUnknownEffect(JoinSnapshot);
192
+ const decodeSuspensionSnapshot = Schema.decodeUnknownEffect(SuspensionSnapshot);
193
+ const decodeApprovalDecisionIntent = Schema.decodeUnknownEffect(ApprovalDecisionIntent);
194
+ const decodeUnknownResolutionIntent = Schema.decodeUnknownEffect(UnknownResolutionIntent);
195
+ const decodeParentLinkage = Schema.decodeUnknownEffect(ParentLinkage);
196
+ const decodeChildReservationSnapshotUnknown = Schema.decodeUnknownEffect(ChildBudgetReservationSnapshot);
197
+ const decodeChildAttachmentSnapshot = Schema.decodeUnknownEffect(ChildAttachmentSnapshot);
198
+ const equivalentPersistedJson = Schema.toEquivalence(PersistedJson);
199
+ const equivalentUnknownResolution = Schema.toEquivalence(UnknownResolution);
200
+ const isSqliteTransactionFailure = Schema.is(Schema.Union([SqliteStorageError, SqliteWriteContention]));
201
+ /** Wrap an adapter-internal failure into the port's LedgerError without erasing its tag. */
202
+ const internalFailure = (operation) => (error) => LedgerError.make({
203
+ operation,
204
+ message: error.message,
205
+ cause: error
206
+ });
207
+ /** Classify raw SQL failures: write-lock timeouts stay retryable typed contention. */
208
+ const sqlFailure = (operation) => (error) => {
209
+ const internal = error.reason._tag === "LockTimeoutError" ? SqliteWriteContention.make({
210
+ cause: error,
211
+ operation,
212
+ message: `Another producer holds the SQLite write lock; ${operation} is safe to retry.`
213
+ }) : SqliteLedgerError.make({
214
+ cause: error,
215
+ operation,
216
+ message: error.message
217
+ });
218
+ return internalFailure(operation)(internal);
219
+ };
220
+ const corruptionFailure = (operation, table, rowKey, message) => internalFailure(operation)(SqliteStorageCorruptionError.make({
221
+ table,
222
+ rowKey,
223
+ message
224
+ }));
225
+ const makeServices = Effect.fn("SqliteSubmissionLedger.makeServices")(function* () {
226
+ const config = yield* SqliteStorageConfig;
227
+ const failpoint = yield* SqliteStorageFailpoint;
228
+ const sql = yield* SqlClientService.SqlClient;
229
+ const crypto = yield* Crypto.Crypto;
230
+ const admissionFence = yield* SubmissionAdmissionFence;
231
+ const journal = yield* initializeSqliteJournal();
232
+ const hitFailpoint = (location, operation) => failpoint.hit(location).pipe(Effect.mapError((error) => internalFailure(operation)(error)));
233
+ /**
234
+ * Run one ledger mutation under the journal's `BEGIN IMMEDIATE` write transaction so
235
+ * ownership-token and epoch checks are atomic with their writes (DUR-006). Transaction
236
+ * acquisition failures surface as LedgerError carrying the typed retryable
237
+ * SqliteWriteContention (or SqliteStorageError) as cause.
238
+ */
239
+ const inWriteTransaction = (operation, effect) => journal.withWriteTransaction(operation)(effect).pipe(Effect.mapError((error) => isSqliteTransactionFailure(error) ? internalFailure(operation)(error) : error));
240
+ const mintIdentifier = (prefix, operation) => crypto.randomUUIDv7.pipe(Effect.map((uuid) => `${prefix}-${uuid}`), Effect.mapError((error) => internalFailure(operation)(error)));
241
+ const currentInstant = Effect.map(Clock.currentTimeMillis, (millis) => ({
242
+ millis,
243
+ iso: new Date(millis).toISOString()
244
+ }));
245
+ const timestampMillis = (operation, rowKey) => (timestamp) => decodeUtcInstant(timestamp).pipe(Effect.map(DateTime.toEpochMillis), Effect.mapError((error) => corruptionFailure(operation, "effect_agent_submission_ownership", rowKey, error.message)));
246
+ const decodeSubmissionRows = (operation, rowKey, rows) => decodeRows(Schema.Array(SubmissionRow), "effect_agent_submissions", rowKey, rows).pipe(Effect.mapError(internalFailure(operation)));
247
+ const readSubmission = Effect.fn("SqliteSubmissionLedger.readSubmission")(function* (operation, submissionId) {
248
+ const rows = yield* sql`
249
+ SELECT ${sql.literal(SUBMISSION_COLUMNS)}
250
+ FROM effect_agent_submissions
251
+ WHERE submission_id = ${submissionId}
252
+ `.pipe(Effect.mapError(sqlFailure(operation)));
253
+ const decoded = yield* decodeSubmissionRows(operation, submissionId, rows);
254
+ if (decoded.length > 1) return yield* corruptionFailure(operation, "effect_agent_submissions", submissionId, "A submission primary key returned more than one row.");
255
+ return decoded.length === 0 ? Option.none() : Option.some(decoded[0]);
256
+ });
257
+ const requireSubmission = Effect.fn("SqliteSubmissionLedger.requireSubmission")(function* (operation, submissionId) {
258
+ const submission = yield* readSubmission(operation, submissionId);
259
+ if (Option.isNone(submission)) return yield* LedgerError.make({
260
+ operation,
261
+ message: `Unknown submission ${submissionId}.`
262
+ });
263
+ return submission.value;
264
+ });
265
+ const readOwnership = Effect.fn("SqliteSubmissionLedger.readOwnership")(function* (operation, submissionId) {
266
+ const rows = yield* sql`
267
+ SELECT
268
+ submission_id,
269
+ attempt_id,
270
+ ownership_token,
271
+ producer_epoch,
272
+ owner_producer_id,
273
+ lease_expires_at
274
+ FROM effect_agent_submission_ownership
275
+ WHERE submission_id = ${submissionId}
276
+ `.pipe(Effect.mapError(sqlFailure(operation)));
277
+ const decoded = yield* decodeRows(Schema.Array(OwnershipRow), "effect_agent_submission_ownership", submissionId, rows).pipe(Effect.mapError(internalFailure(operation)));
278
+ if (decoded.length > 1) return yield* corruptionFailure(operation, "effect_agent_submission_ownership", submissionId, "An ownership primary key returned more than one row.");
279
+ return decoded.length === 0 ? Option.none() : Option.some(decoded[0]);
280
+ });
281
+ const threadEpoch = Effect.fn("SqliteSubmissionLedger.threadEpoch")(function* (operation, threadId) {
282
+ const threads = yield* journal.getThread(threadId).pipe(Effect.mapError(internalFailure(operation)));
283
+ return threads.length === 0 ? EPOCH_ZERO : threads[0].producer_epoch;
284
+ });
285
+ /**
286
+ * Verify inside the surrounding write transaction that the presented token still owns the
287
+ * Submission's lane; a superseded or missing token fails with OwnershipLost carrying the
288
+ * Thread's current producer epoch (DUR-006).
289
+ */
290
+ const requireOwnership = Effect.fn("SqliteSubmissionLedger.requireOwnership")(function* (operation, submission, ownershipToken) {
291
+ const ownership = yield* readOwnership(operation, submission.submission_id);
292
+ if (Option.isNone(ownership) || ownership.value.ownership_token !== ownershipToken) {
293
+ const actualEpoch = yield* threadEpoch(operation, submission.thread_id);
294
+ const submissionId = yield* Schema.decodeUnknownEffect(SubmissionSnapshot.fields.submissionId)(submission.submission_id).pipe(Effect.mapError(internalFailure(operation)));
295
+ return yield* OwnershipLost.make({
296
+ submissionId,
297
+ actualEpoch
298
+ });
299
+ }
300
+ return ownership.value;
301
+ });
302
+ const decodeSubmissionSnapshot = Effect.fn("SqliteSubmissionLedger.decodeSubmissionSnapshot")(function* (operation, row) {
303
+ const agentDigests = yield* parseStoredJsonText(row.agent_digests_json).pipe(Effect.mapError((error) => corruptionFailure(operation, "effect_agent_submissions", row.submission_id, error.message)));
304
+ const inputPayload = yield* parseStoredJsonText(row.input_json).pipe(Effect.mapError((error) => corruptionFailure(operation, "effect_agent_submissions", row.submission_id, error.message)));
305
+ if (row.parent_submission_id === null !== (row.parent_tool_call_id === null)) return yield* corruptionFailure(operation, "effect_agent_submissions", row.submission_id, "A parent linkage must record both the parent Submission and the parent Tool Call.");
306
+ return yield* decodeSubmissionSnapshotUnknown({
307
+ submissionId: row.submission_id,
308
+ threadId: row.thread_id,
309
+ queueSequence: row.queue_sequence,
310
+ principal: row.principal,
311
+ idempotencyKey: row.idempotency_key,
312
+ agentId: row.agent_id,
313
+ agentDigests,
314
+ deploymentId: row.deployment_id,
315
+ inputPayload,
316
+ inputDigest: row.input_digest,
317
+ receiptId: row.receipt_id,
318
+ state: row.state,
319
+ createdAt: row.created_at,
320
+ ...row.admission_group === null ? {} : { admissionGroup: row.admission_group },
321
+ ...row.worker_admission_json === null ? {} : { workerAdmission: yield* parseStoredJsonText(row.worker_admission_json).pipe(Effect.mapError(internalFailure(operation))) },
322
+ ...row.message_admission_json === null ? {} : { messageAdmission: yield* parseStoredJsonText(row.message_admission_json).pipe(Effect.mapError(internalFailure(operation))) },
323
+ ...row.admission_fence_json === null ? {} : { admissionFence: yield* parseStoredJsonText(row.admission_fence_json).pipe(Effect.mapError(internalFailure(operation))) },
324
+ ...row.settled_outcome === null ? {} : { settledOutcome: row.settled_outcome },
325
+ ...row.ready_at === null ? {} : { readyAt: row.ready_at },
326
+ ...row.parent_submission_id === null || row.parent_tool_call_id === null ? {} : { parentLinkage: {
327
+ parentSubmissionId: row.parent_submission_id,
328
+ parentToolCallId: row.parent_tool_call_id
329
+ } }
330
+ }).pipe(Effect.mapError((error) => corruptionFailure(operation, "effect_agent_submissions", row.submission_id, error.message)));
331
+ });
332
+ const readReservation = Effect.fn("SqliteSubmissionLedger.readReservation")(function* (operation, submissionId) {
333
+ const rows = yield* sql`
334
+ SELECT
335
+ submission_id,
336
+ settlement_id,
337
+ outcome,
338
+ record_id,
339
+ record_json,
340
+ record_digest,
341
+ reserved_at,
342
+ finalized_at
343
+ FROM effect_agent_settlement_reservations
344
+ WHERE submission_id = ${submissionId}
345
+ `.pipe(Effect.mapError(sqlFailure(operation)));
346
+ const decoded = yield* decodeRows(Schema.Array(ReservationRow), "effect_agent_settlement_reservations", submissionId, rows).pipe(Effect.mapError(internalFailure(operation)));
347
+ if (decoded.length > 1) return yield* corruptionFailure(operation, "effect_agent_settlement_reservations", submissionId, "A settlement reservation primary key returned more than one row.");
348
+ return decoded.length === 0 ? Option.none() : Option.some(decoded[0]);
349
+ });
350
+ const readAbortIntent = Effect.fn("SqliteSubmissionLedger.readAbortIntent")(function* (operation, submissionId) {
351
+ const rows = yield* sql`
352
+ SELECT
353
+ submission_id,
354
+ author,
355
+ reason,
356
+ requested_at,
357
+ canonical_record_id
358
+ FROM effect_agent_abort_intents
359
+ WHERE submission_id = ${submissionId}
360
+ `.pipe(Effect.mapError(sqlFailure(operation)));
361
+ const decoded = yield* decodeRows(Schema.Array(AbortIntentRow), "effect_agent_abort_intents", submissionId, rows).pipe(Effect.mapError(internalFailure(operation)));
362
+ if (decoded.length > 1) return yield* corruptionFailure(operation, "effect_agent_abort_intents", submissionId, "An abort intent primary key returned more than one row.");
363
+ return decoded.length === 0 ? Option.none() : Option.some(decoded[0]);
364
+ });
365
+ const decodeChildReservationRows = (operation, rowKey, rows) => decodeRows(Schema.Array(ChildReservationRow), "effect_agent_child_reservations", rowKey, rows).pipe(Effect.mapError(internalFailure(operation)));
366
+ const readChildReservation = Effect.fn("SqliteSubmissionLedger.readChildReservation")(function* (operation, reservationId) {
367
+ const rows = yield* sql`
368
+ SELECT ${sql.literal(CHILD_RESERVATION_COLUMNS)}
369
+ FROM effect_agent_child_reservations
370
+ WHERE reservation_id = ${reservationId}
371
+ `.pipe(Effect.mapError(sqlFailure(operation)));
372
+ const decoded = yield* decodeChildReservationRows(operation, reservationId, rows);
373
+ if (decoded.length > 1) return yield* corruptionFailure(operation, "effect_agent_child_reservations", reservationId, "A child reservation primary key returned more than one row.");
374
+ return decoded.length === 0 ? Option.none() : Option.some(decoded[0]);
375
+ });
376
+ const readChildReservationForCall = Effect.fn("SqliteSubmissionLedger.readChildReservationForCall")(function* (operation, parentSubmissionId, parentToolCallId) {
377
+ const rows = yield* sql`
378
+ SELECT ${sql.literal(CHILD_RESERVATION_COLUMNS)}
379
+ FROM effect_agent_child_reservations
380
+ WHERE parent_submission_id = ${parentSubmissionId}
381
+ AND parent_tool_call_id = ${parentToolCallId}
382
+ `.pipe(Effect.mapError(sqlFailure(operation)));
383
+ const decoded = yield* decodeChildReservationRows(operation, `${parentSubmissionId}/${parentToolCallId}`, rows);
384
+ if (decoded.length > 1) return yield* corruptionFailure(operation, "effect_agent_child_reservations", `${parentSubmissionId}/${parentToolCallId}`, "A parent Tool Call returned more than one child reservation.");
385
+ return decoded.length === 0 ? Option.none() : Option.some(decoded[0]);
386
+ });
387
+ const childReservationSnapshotFromRow = Effect.fn("SqliteSubmissionLedger.childReservationSnapshotFromRow")(function* (operation, row) {
388
+ const rowFailure = (error) => corruptionFailure(operation, "effect_agent_child_reservations", row.reservation_id, error.message);
389
+ const allocation = yield* parseStoredJsonText(row.allocation_json).pipe(Effect.mapError(rowFailure));
390
+ const accounting = row.accounting_json === null ? void 0 : yield* parseStoredJsonText(row.accounting_json).pipe(Effect.mapError(rowFailure));
391
+ return yield* decodeChildReservationSnapshotUnknown({
392
+ reservationId: row.reservation_id,
393
+ parentSubmissionId: row.parent_submission_id,
394
+ parentToolCallId: row.parent_tool_call_id,
395
+ status: row.status,
396
+ allocation,
397
+ allocationDigest: row.allocation_digest,
398
+ reservedAt: row.reserved_at,
399
+ ...row.child_submission_id === null ? {} : { childSubmissionId: row.child_submission_id },
400
+ ...accounting === void 0 ? {} : { accounting },
401
+ ...row.release_began_at === null ? {} : { releaseBeganAt: row.release_began_at },
402
+ ...row.released_at === null ? {} : { releasedAt: row.released_at }
403
+ }).pipe(Effect.mapError(rowFailure));
404
+ });
405
+ const readApprovalDecisions = Effect.fn("SqliteSubmissionLedger.readApprovalDecisions")(function* (operation, submissionId) {
406
+ const rows = yield* sql`
407
+ SELECT
408
+ submission_id,
409
+ tool_call_id,
410
+ decision,
411
+ resolver,
412
+ reason,
413
+ decided_at
414
+ FROM effect_agent_approval_decisions
415
+ WHERE submission_id = ${submissionId}
416
+ ORDER BY tool_call_id ASC
417
+ `.pipe(Effect.mapError(sqlFailure(operation)));
418
+ return yield* decodeRows(Schema.Array(ApprovalDecisionRow), "effect_agent_approval_decisions", submissionId, rows).pipe(Effect.mapError(internalFailure(operation)));
419
+ });
420
+ const approvalIntentFromRow = Effect.fn("SqliteSubmissionLedger.approvalIntentFromRow")(function* (operation, row) {
421
+ return yield* decodeApprovalDecisionIntent({
422
+ submissionId: row.submission_id,
423
+ toolCallId: row.tool_call_id,
424
+ decision: row.decision,
425
+ resolver: row.resolver,
426
+ reason: row.reason,
427
+ decidedAt: row.decided_at
428
+ }).pipe(Effect.mapError((error) => corruptionFailure(operation, "effect_agent_approval_decisions", `${row.submission_id}/${row.tool_call_id}`, error.message)));
429
+ });
430
+ const readUnknownResolutions = Effect.fn("SqliteSubmissionLedger.readUnknownResolutions")(function* (operation, submissionId) {
431
+ const rows = yield* sql`
432
+ SELECT
433
+ submission_id,
434
+ tool_call_id,
435
+ author,
436
+ reason,
437
+ resolution_json,
438
+ resolved_at
439
+ FROM effect_agent_unknown_resolutions
440
+ WHERE submission_id = ${submissionId}
441
+ ORDER BY tool_call_id ASC
442
+ `.pipe(Effect.mapError(sqlFailure(operation)));
443
+ return yield* decodeRows(Schema.Array(UnknownResolutionRow), "effect_agent_unknown_resolutions", submissionId, rows).pipe(Effect.mapError(internalFailure(operation)));
444
+ });
445
+ const unknownResolutionIntentFromRow = Effect.fn("SqliteSubmissionLedger.unknownResolutionIntentFromRow")(function* (operation, row) {
446
+ const resolution = yield* parseStoredJsonText(row.resolution_json).pipe(Effect.mapError((error) => corruptionFailure(operation, "effect_agent_unknown_resolutions", `${row.submission_id}/${row.tool_call_id}`, error.message)));
447
+ return yield* decodeUnknownResolutionIntent({
448
+ submissionId: row.submission_id,
449
+ toolCallId: row.tool_call_id,
450
+ author: row.author,
451
+ reason: row.reason,
452
+ resolution,
453
+ resolvedAt: row.resolved_at
454
+ }).pipe(Effect.mapError((error) => corruptionFailure(operation, "effect_agent_unknown_resolutions", `${row.submission_id}/${row.tool_call_id}`, error.message)));
455
+ });
456
+ /** The Submission's marked-unknown open Tool Call identities, empty when never marked. */
457
+ const storedUnknownToolCallIds = Effect.fn("SqliteSubmissionLedger.storedUnknownToolCallIds")(function* (operation, submission) {
458
+ if (submission.unknown_tool_call_ids_json === null) return [];
459
+ return yield* decodeToolCallIdsText(submission.unknown_tool_call_ids_json).pipe(Effect.mapError((error) => corruptionFailure(operation, "effect_agent_submissions", submission.submission_id, error.message)));
460
+ });
461
+ /**
462
+ * Canonical history is the abort authority (DUR-015): the intent's canonicalRecordId is
463
+ * derived from the shared canonical-records table using the deterministic abort record
464
+ * identity, never from a cached ledger marker.
465
+ */
466
+ const canonicalAbortRecordId = Effect.fn("SqliteSubmissionLedger.canonicalAbortRecordId")(function* (operation, threadId, submissionId) {
467
+ const recordId = submissionAbortRecordId(submissionId);
468
+ const rows = yield* sql`
469
+ SELECT record_id
470
+ FROM effect_agent_canonical_records
471
+ WHERE thread_id = ${threadId}
472
+ AND record_id = ${recordId}
473
+ `.pipe(Effect.mapError(sqlFailure(operation)));
474
+ return (yield* decodeRows(Schema.Array(CanonicalRecordIdRow), "effect_agent_canonical_records", `${threadId}/${recordId}`, rows).pipe(Effect.mapError(internalFailure(operation)))).length === 0 ? void 0 : recordId;
475
+ });
476
+ const abortIntentFromRow = Effect.fn("SqliteSubmissionLedger.abortIntentFromRow")(function* (operation, submission, submissionId, row) {
477
+ const canonicalRecordId = yield* canonicalAbortRecordId(operation, submission.thread_id, submissionId);
478
+ return yield* decodeAbortIntent({
479
+ submissionId: row.submission_id,
480
+ author: row.author,
481
+ reason: row.reason,
482
+ requestedAt: row.requested_at,
483
+ ...canonicalRecordId === void 0 ? {} : { canonicalRecordId }
484
+ }).pipe(Effect.mapError((error) => corruptionFailure(operation, "effect_agent_abort_intents", row.submission_id, error.message)));
485
+ });
486
+ const capabilities = Effect.succeed(LedgerCapabilities.make({ durability: "durable-node" }));
487
+ const admit = Effect.fn("SqliteSubmissionLedger.admit")(function* (request) {
488
+ const operation = "ledger admit";
489
+ const validated = yield* Schema.decodeUnknownEffect(Schema.toType(AdmissionRequest))(request).pipe(Effect.mapError(internalFailure(operation)));
490
+ const inputJson = yield* encodePersistedJsonText(validated.inputPayload).pipe(Effect.mapError(internalFailure(operation)));
491
+ const workerAdmissionJson = validated.workerAdmission === void 0 ? null : yield* Schema.encodeEffect(Schema.fromJsonString(WorkerAdmission))(validated.workerAdmission).pipe(Effect.mapError(internalFailure(operation)));
492
+ if (workerAdmissionJson !== null && new TextEncoder().encode(workerAdmissionJson).byteLength > 16777216) return yield* LedgerError.make({
493
+ operation,
494
+ message: "Worker admission metadata exceeds the stored value bound"
495
+ });
496
+ const messageAdmissionJson = validated.messageAdmission === void 0 ? null : yield* Schema.encodeEffect(Schema.fromJsonString(MessageAdmission))(validated.messageAdmission).pipe(Effect.mapError(internalFailure(operation)));
497
+ if (messageAdmissionJson !== null && new TextEncoder().encode(messageAdmissionJson).byteLength > 16777216) return yield* LedgerError.make({
498
+ operation,
499
+ message: "Message admission metadata exceeds the stored value bound"
500
+ });
501
+ const agentDigestsJson = yield* encodeDefinitionDigestsText(validated.agentDigests).pipe(Effect.mapError(internalFailure(operation)));
502
+ const mintedSubmissionId = yield* mintIdentifier("submission", operation);
503
+ const mintedReceiptId = yield* mintIdentifier("receipt", operation);
504
+ yield* hitFailpoint("ledger:admit:before", operation);
505
+ const result = yield* inWriteTransaction(operation, Effect.gen(function* () {
506
+ const keyRowKey = `${validated.threadId}/${validated.principal}/${validated.idempotencyKey}`;
507
+ const existingRows = yield* sql`
508
+ SELECT ${sql.literal(SUBMISSION_COLUMNS)}
509
+ FROM effect_agent_submissions
510
+ WHERE thread_id = ${validated.threadId}
511
+ AND principal = ${validated.principal}
512
+ AND idempotency_key = ${validated.idempotencyKey}
513
+ `.pipe(Effect.mapError(sqlFailure(operation)));
514
+ const existing = yield* decodeSubmissionRows(operation, keyRowKey, existingRows);
515
+ if (existing.length > 1) return yield* corruptionFailure(operation, "effect_agent_submissions", keyRowKey, "An admission idempotency key returned more than one row.");
516
+ if (existing.length === 1) {
517
+ const sameLinkage = validated.parentLinkage === void 0 ? existing[0].parent_submission_id === null && existing[0].parent_tool_call_id === null : existing[0].parent_submission_id === validated.parentLinkage.parentSubmissionId && existing[0].parent_tool_call_id === validated.parentLinkage.parentToolCallId;
518
+ if (existing[0].input_digest !== validated.inputDigest || !sameLinkage) return yield* AdmissionConflict.make({
519
+ threadId: validated.threadId,
520
+ principal: validated.principal,
521
+ idempotencyKey: validated.idempotencyKey,
522
+ existingInputDigest: existing[0].input_digest,
523
+ attemptedInputDigest: validated.inputDigest
524
+ });
525
+ const retainedWorkerAdmission = existing[0].worker_admission_json === null ? void 0 : yield* Schema.decodeEffect(Schema.fromJsonString(WorkerAdmission))(existing[0].worker_admission_json).pipe(Effect.mapError(internalFailure(operation)));
526
+ const retainedMessageAdmission = existing[0].message_admission_json === null ? void 0 : yield* Schema.decodeEffect(Schema.fromJsonString(MessageAdmission))(existing[0].message_admission_json).pipe(Effect.mapError(internalFailure(operation)));
527
+ const retainedFence = existing[0].admission_fence_json === null ? void 0 : yield* Schema.decodeEffect(Schema.fromJsonString(AdmissionFence))(existing[0].admission_fence_json).pipe(Effect.mapError(internalFailure(operation)));
528
+ if ((existing[0].admission_group ?? void 0) !== validated.admissionGroup || !Schema.toEquivalence(Schema.optional(WorkerAdmission))(retainedWorkerAdmission, validated.workerAdmission) || !Schema.toEquivalence(Schema.optional(MessageAdmission))(retainedMessageAdmission, validated.messageAdmission) || !Schema.toEquivalence(Schema.optional(AdmissionFence))(retainedFence, validated.admissionFence)) return yield* AdmissionConflict.make({
529
+ threadId: validated.threadId,
530
+ principal: validated.principal,
531
+ idempotencyKey: validated.idempotencyKey,
532
+ existingInputDigest: existing[0].input_digest,
533
+ attemptedInputDigest: validated.inputDigest
534
+ });
535
+ return yield* decodeAdmissionResult({
536
+ submissionId: existing[0].submission_id,
537
+ receiptId: existing[0].receipt_id,
538
+ queueSequence: existing[0].queue_sequence,
539
+ state: existing[0].state,
540
+ replayed: true
541
+ }).pipe(Effect.mapError(internalFailure(operation)));
542
+ }
543
+ const firstRows = yield* sql`
544
+ SELECT worker_admission_json FROM effect_agent_submissions
545
+ WHERE thread_id=${validated.threadId} ORDER BY queue_sequence LIMIT 1
546
+ `.pipe(Effect.mapError(sqlFailure(operation)));
547
+ const first = yield* Schema.decodeUnknownEffect(Schema.Array(Schema.Struct({ worker_admission_json: Schema.NullOr(BoundedStoredText) })))(firstRows).pipe(Effect.mapError(internalFailure(operation)));
548
+ if (first[0] !== void 0) {
549
+ const previous = first[0].worker_admission_json === null ? void 0 : yield* Schema.decodeEffect(Schema.fromJsonString(WorkerAdmission))(first[0].worker_admission_json).pipe(Effect.mapError(internalFailure(operation)));
550
+ if (!Schema.toEquivalence(Schema.optional(WorkerAdmission.fields.origin))(previous?.origin, validated.workerAdmission?.origin)) return yield* AdmissionPolicyError.make({
551
+ reason: "refused",
552
+ code: "worker-origin-conflict"
553
+ });
554
+ }
555
+ yield* admissionFence.check(validated);
556
+ if (validated.admissionGroup !== void 0) {
557
+ if ((yield* sql`
558
+ SELECT submission_id FROM effect_agent_submissions
559
+ WHERE thread_id=${validated.threadId} AND admission_group=${validated.admissionGroup} AND state<>'settled' LIMIT 1
560
+ `.pipe(Effect.mapError(sqlFailure(operation)))).length > 0) return yield* AdmissionPolicyError.make({
561
+ reason: "occupied",
562
+ code: "admission-group"
563
+ });
564
+ }
565
+ const maxRows = yield* sql`
566
+ SELECT COALESCE(MAX(queue_sequence), 0) AS max_queue_sequence
567
+ FROM effect_agent_submissions
568
+ WHERE thread_id = ${validated.threadId}
569
+ `.pipe(Effect.mapError(sqlFailure(operation)));
570
+ const decodedMax = yield* decodeRows(Schema.Array(MaxQueueSequenceRow), "effect_agent_submissions", validated.threadId, maxRows).pipe(Effect.mapError(internalFailure(operation)));
571
+ const queueSequence = yield* decodeQueueSequence((decodedMax[0]?.max_queue_sequence ?? 0) + 1).pipe(Effect.mapError(internalFailure(operation)));
572
+ const now = yield* currentInstant;
573
+ yield* sql`
574
+ INSERT INTO effect_agent_submissions (
575
+ submission_id,
576
+ thread_id,
577
+ queue_sequence,
578
+ principal,
579
+ idempotency_key,
580
+ agent_id,
581
+ agent_digests_json,
582
+ deployment_id,
583
+ input_json,
584
+ input_digest,
585
+ receipt_id,
586
+ state,
587
+ created_at,
588
+ parent_submission_id,
589
+ parent_tool_call_id,
590
+ admission_group,
591
+ admission_fence_json,
592
+ worker_admission_json,
593
+ message_admission_json
594
+ ) VALUES (
595
+ ${mintedSubmissionId},
596
+ ${validated.threadId},
597
+ ${queueSequence},
598
+ ${validated.principal},
599
+ ${validated.idempotencyKey},
600
+ ${validated.agentId},
601
+ ${agentDigestsJson},
602
+ ${validated.deploymentId},
603
+ ${inputJson},
604
+ ${validated.inputDigest},
605
+ ${mintedReceiptId},
606
+ 'admitted',
607
+ ${now.iso},
608
+ ${validated.parentLinkage?.parentSubmissionId ?? null},
609
+ ${validated.parentLinkage?.parentToolCallId ?? null},
610
+ ${validated.admissionGroup ?? null},
611
+ ${validated.admissionFence === void 0 ? null : JSON.stringify(validated.admissionFence)},
612
+ ${workerAdmissionJson},
613
+ ${messageAdmissionJson}
614
+ )
615
+ `.pipe(Effect.mapError(sqlFailure(operation)));
616
+ return yield* decodeAdmissionResult({
617
+ submissionId: mintedSubmissionId,
618
+ receiptId: mintedReceiptId,
619
+ queueSequence,
620
+ state: "admitted",
621
+ replayed: false
622
+ }).pipe(Effect.mapError(internalFailure(operation)));
623
+ }));
624
+ yield* hitFailpoint("ledger:admit:after", operation);
625
+ return result;
626
+ });
627
+ const markReady = Effect.fn("SqliteSubmissionLedger.markReady")(function* (request) {
628
+ const operation = "ledger mark ready";
629
+ const validated = yield* Schema.decodeUnknownEffect(Schema.toType(MarkReadyRequest))(request).pipe(Effect.mapError(internalFailure(operation)));
630
+ yield* hitFailpoint("ledger:mark-ready:before", operation);
631
+ yield* inWriteTransaction(operation, Effect.gen(function* () {
632
+ if ((yield* requireSubmission(operation, validated.submissionId)).state !== "admitted") return;
633
+ const now = yield* currentInstant;
634
+ yield* sql`
635
+ UPDATE effect_agent_submissions
636
+ SET state = 'ready', ready_at = ${now.iso}
637
+ WHERE submission_id = ${validated.submissionId}
638
+ `.pipe(Effect.mapError(sqlFailure(operation)));
639
+ }));
640
+ yield* hitFailpoint("ledger:mark-ready:after", operation);
641
+ });
642
+ const lookup = Effect.fn("SqliteSubmissionLedger.lookup")(function* (request) {
643
+ const operation = "ledger lookup";
644
+ const validated = yield* Schema.decodeUnknownEffect(Schema.toType(SubmissionLookup))(request).pipe(Effect.mapError(internalFailure(operation)));
645
+ if (validated._tag === "SubmissionLookupById") {
646
+ const row = yield* readSubmission(operation, validated.submissionId);
647
+ if (Option.isNone(row)) return Option.none();
648
+ return Option.some(yield* decodeSubmissionSnapshot(operation, row.value));
649
+ }
650
+ const rows = yield* sql`
651
+ SELECT ${sql.literal(SUBMISSION_COLUMNS)}
652
+ FROM effect_agent_submissions
653
+ WHERE thread_id = ${validated.threadId}
654
+ AND principal = ${validated.principal}
655
+ AND idempotency_key = ${validated.idempotencyKey}
656
+ `.pipe(Effect.mapError(sqlFailure(operation)));
657
+ const decoded = yield* decodeSubmissionRows(operation, `${validated.threadId}/${validated.principal}/${validated.idempotencyKey}`, rows);
658
+ if (decoded.length > 1) return yield* corruptionFailure(operation, "effect_agent_submissions", `${validated.threadId}/${validated.principal}/${validated.idempotencyKey}`, "An admission idempotency key returned more than one row.");
659
+ if (decoded.length === 0) return Option.none();
660
+ return Option.some(yield* decodeSubmissionSnapshot(operation, decoded[0]));
661
+ });
662
+ const resolveAdmission = Effect.fn("SqliteSubmissionLedger.resolveAdmission")(function* (request) {
663
+ const operation = "ledger resolve admission";
664
+ const validated = yield* Schema.decodeUnknownEffect(Schema.toType(SubmissionLookupByKey))(request).pipe(Effect.mapError(internalFailure(operation)));
665
+ const rows = yield* sql`
666
+ SELECT ${sql.literal(SUBMISSION_COLUMNS)}
667
+ FROM effect_agent_submissions
668
+ WHERE thread_id = ${validated.threadId}
669
+ AND principal = ${validated.principal}
670
+ AND idempotency_key = ${validated.idempotencyKey}
671
+ `.pipe(Effect.mapError(sqlFailure(operation)));
672
+ const decoded = yield* decodeSubmissionRows(operation, `${validated.threadId}/${validated.principal}/${validated.idempotencyKey}`, rows);
673
+ if (decoded.length > 1) return yield* corruptionFailure(operation, "effect_agent_submissions", `${validated.threadId}/${validated.principal}/${validated.idempotencyKey}`, "An admission idempotency key returned more than one row.");
674
+ if (decoded.length === 0) return AdmissionNotAdmitted.make();
675
+ return AdmissionAdmitted.make({ submission: yield* decodeSubmissionSnapshot(operation, decoded[0]) });
676
+ });
677
+ const claim = Effect.fn("SqliteSubmissionLedger.claim")(function* (request) {
678
+ const operation = "ledger claim";
679
+ const validated = yield* Schema.decodeUnknownEffect(Schema.toType(ClaimRequest))(request).pipe(Effect.mapError(internalFailure(operation)));
680
+ const attemptId = yield* mintIdentifier("attempt", operation);
681
+ const ownershipToken = yield* mintIdentifier("owner", operation);
682
+ yield* hitFailpoint("ledger:claim:before", operation);
683
+ const claimed = yield* inWriteTransaction(operation, Effect.gen(function* () {
684
+ const headRows = yield* sql`
685
+ SELECT ${sql.literal(SUBMISSION_COLUMNS)}
686
+ FROM effect_agent_submissions
687
+ WHERE thread_id = ${validated.threadId}
688
+ AND state <> 'settled'
689
+ ORDER BY queue_sequence ASC
690
+ LIMIT 1
691
+ `.pipe(Effect.mapError(sqlFailure(operation)));
692
+ const heads = yield* decodeSubmissionRows(operation, validated.threadId, headRows);
693
+ if (heads.length === 0) return Option.none();
694
+ const head = heads[0];
695
+ if (head.state === "joining" || head.state === "joined" || head.state === "suspended" || head.state === "unknown" && Option.isNone(yield* readAbortIntent(operation, head.submission_id))) return Option.none();
696
+ const now = yield* currentInstant;
697
+ const ownership = yield* readOwnership(operation, head.submission_id);
698
+ if (Option.isSome(ownership)) {
699
+ if ((yield* timestampMillis(operation, head.submission_id)(ownership.value.lease_expires_at)) > now.millis) return Option.none();
700
+ }
701
+ const threads = yield* journal.getThread(head.thread_id).pipe(Effect.mapError(internalFailure(operation)));
702
+ let producerEpoch;
703
+ if (threads.length === 0) {
704
+ producerEpoch = 1;
705
+ yield* sql`
706
+ INSERT INTO effect_agent_threads (
707
+ thread_id,
708
+ created_at,
709
+ tail_sequence,
710
+ tail_digest,
711
+ producer_epoch
712
+ ) VALUES (
713
+ ${head.thread_id},
714
+ ${now.iso},
715
+ 0,
716
+ ${EMPTY_TAIL_DIGEST},
717
+ ${producerEpoch}
718
+ )
719
+ `.pipe(Effect.mapError(sqlFailure(operation)));
720
+ } else {
721
+ producerEpoch = threads[0].producer_epoch + 1;
722
+ yield* sql`
723
+ UPDATE effect_agent_threads
724
+ SET producer_epoch = ${producerEpoch}
725
+ WHERE thread_id = ${head.thread_id}
726
+ `.pipe(Effect.mapError(sqlFailure(operation)));
727
+ }
728
+ const leaseExpiresAt = new Date(now.millis + config.ownershipLeaseDuration).toISOString();
729
+ yield* sql`
730
+ INSERT INTO effect_agent_submission_ownership (
731
+ submission_id,
732
+ attempt_id,
733
+ ownership_token,
734
+ producer_epoch,
735
+ owner_producer_id,
736
+ lease_expires_at
737
+ ) VALUES (
738
+ ${head.submission_id},
739
+ ${attemptId},
740
+ ${ownershipToken},
741
+ ${producerEpoch},
742
+ ${validated.producerId},
743
+ ${leaseExpiresAt}
744
+ )
745
+ ON CONFLICT (submission_id) DO UPDATE SET
746
+ attempt_id = excluded.attempt_id,
747
+ ownership_token = excluded.ownership_token,
748
+ producer_epoch = excluded.producer_epoch,
749
+ owner_producer_id = excluded.owner_producer_id,
750
+ lease_expires_at = excluded.lease_expires_at
751
+ `.pipe(Effect.mapError(sqlFailure(operation)));
752
+ yield* sql`
753
+ INSERT INTO effect_agent_attempts (
754
+ attempt_id,
755
+ submission_id,
756
+ thread_id,
757
+ owner_producer_id,
758
+ producer_epoch,
759
+ claimed_at
760
+ ) VALUES (
761
+ ${attemptId},
762
+ ${head.submission_id},
763
+ ${head.thread_id},
764
+ ${validated.producerId},
765
+ ${producerEpoch},
766
+ ${now.iso}
767
+ )
768
+ `.pipe(Effect.mapError(sqlFailure(operation)));
769
+ if (head.state === "ready") yield* sql`
770
+ UPDATE effect_agent_submissions
771
+ SET state = 'running'
772
+ WHERE submission_id = ${head.submission_id}
773
+ `.pipe(Effect.mapError(sqlFailure(operation)));
774
+ const inputPayload = yield* parseStoredJsonText(head.input_json).pipe(Effect.mapError((error) => corruptionFailure(operation, "effect_agent_submissions", head.submission_id, error.message)));
775
+ return Option.some(yield* decodeClaim({
776
+ submissionId: head.submission_id,
777
+ attemptId,
778
+ ownershipToken,
779
+ producerEpoch,
780
+ leaseExpiresAt,
781
+ inputPayload
782
+ }).pipe(Effect.mapError(internalFailure(operation))));
783
+ }));
784
+ yield* hitFailpoint("ledger:claim:after", operation);
785
+ return claimed;
786
+ });
787
+ const renewOwnership = Effect.fn("SqliteSubmissionLedger.renewOwnership")(function* (request) {
788
+ const operation = "ledger renew ownership";
789
+ const validated = yield* Schema.decodeUnknownEffect(Schema.toType(RenewOwnershipRequest))(request).pipe(Effect.mapError(internalFailure(operation)));
790
+ yield* hitFailpoint("ledger:renew:before", operation);
791
+ const renewal = yield* inWriteTransaction(operation, Effect.gen(function* () {
792
+ const submission = yield* requireSubmission(operation, validated.submissionId);
793
+ yield* requireOwnership(operation, submission, validated.ownershipToken);
794
+ const now = yield* currentInstant;
795
+ const leaseExpiresAt = new Date(now.millis + config.ownershipLeaseDuration).toISOString();
796
+ yield* sql`
797
+ UPDATE effect_agent_submission_ownership
798
+ SET lease_expires_at = ${leaseExpiresAt}
799
+ WHERE submission_id = ${validated.submissionId}
800
+ `.pipe(Effect.mapError(sqlFailure(operation)));
801
+ return yield* decodeOwnershipRenewal({
802
+ ownershipToken: validated.ownershipToken,
803
+ leaseExpiresAt
804
+ }).pipe(Effect.mapError(internalFailure(operation)));
805
+ }));
806
+ yield* hitFailpoint("ledger:renew:after", operation);
807
+ return renewal;
808
+ });
809
+ const releaseOwnership = Effect.fn("SqliteSubmissionLedger.releaseOwnership")(function* (request) {
810
+ const operation = "ledger release ownership";
811
+ const validated = yield* Schema.decodeUnknownEffect(Schema.toType(ReleaseOwnershipRequest))(request).pipe(Effect.mapError(internalFailure(operation)));
812
+ yield* hitFailpoint("ledger:release:before", operation);
813
+ yield* inWriteTransaction(operation, Effect.gen(function* () {
814
+ const submission = yield* requireSubmission(operation, validated.submissionId);
815
+ yield* requireOwnership(operation, submission, validated.ownershipToken);
816
+ yield* sql`
817
+ DELETE FROM effect_agent_submission_ownership
818
+ WHERE submission_id = ${validated.submissionId}
819
+ `.pipe(Effect.mapError(sqlFailure(operation)));
820
+ if (submission.state === "running") yield* sql`
821
+ UPDATE effect_agent_submissions
822
+ SET state = 'ready'
823
+ WHERE submission_id = ${validated.submissionId}
824
+ `.pipe(Effect.mapError(sqlFailure(operation)));
825
+ }));
826
+ yield* hitFailpoint("ledger:release:after", operation);
827
+ });
828
+ const markInputApplied = Effect.fn("SqliteSubmissionLedger.markInputApplied")(function* (request) {
829
+ const operation = "ledger mark input applied";
830
+ const validated = yield* Schema.decodeUnknownEffect(Schema.toType(MarkInputAppliedRequest))(request).pipe(Effect.mapError(internalFailure(operation)));
831
+ yield* hitFailpoint("ledger:mark-input-applied:before", operation);
832
+ yield* inWriteTransaction(operation, Effect.gen(function* () {
833
+ const submission = yield* requireSubmission(operation, validated.submissionId);
834
+ yield* requireOwnership(operation, submission, validated.ownershipToken);
835
+ if (submission.input_applied_record_id !== null) {
836
+ if (submission.input_applied_record_id === validated.recordId && submission.input_applied_sequence === validated.sequence) return;
837
+ return yield* corruptionFailure(operation, "effect_agent_submissions", validated.submissionId, "A different canonical input marker is already recorded for this Submission.");
838
+ }
839
+ yield* sql`
840
+ UPDATE effect_agent_submissions
841
+ SET
842
+ input_applied_record_id = ${validated.recordId},
843
+ input_applied_sequence = ${validated.sequence},
844
+ state = CASE
845
+ WHEN state IN ('admitted', 'ready', 'running') THEN 'input-applied'
846
+ ELSE state
847
+ END
848
+ WHERE submission_id = ${validated.submissionId}
849
+ `.pipe(Effect.mapError(sqlFailure(operation)));
850
+ }));
851
+ yield* hitFailpoint("ledger:mark-input-applied:after", operation);
852
+ });
853
+ const reserveSettlement = Effect.fn("SqliteSubmissionLedger.reserveSettlement")(function* (request) {
854
+ const operation = "ledger reserve settlement";
855
+ const validated = yield* Schema.decodeUnknownEffect(Schema.toType(SettlementReservation))(request).pipe(Effect.mapError(internalFailure(operation)));
856
+ const recordJson = yield* encodeRecordEnvelopeText(validated.record).pipe(Effect.mapError(internalFailure(operation)));
857
+ yield* hitFailpoint("ledger:reserve-settlement:before", operation);
858
+ const reserved = yield* inWriteTransaction(operation, Effect.gen(function* () {
859
+ const existing = yield* readReservation(operation, validated.submissionId);
860
+ if (Option.isSome(existing)) {
861
+ if (!(existing.value.settlement_id === validated.settlementId && existing.value.outcome === validated.outcome && existing.value.record_digest === validated.recordDigest && existing.value.record_json === recordJson)) return yield* SettlementConflict.make({
862
+ submissionId: validated.submissionId,
863
+ existingOutcome: existing.value.outcome
864
+ });
865
+ const record = yield* decodeRecordEnvelopeText(existing.value.record_json).pipe(Effect.mapError((error) => corruptionFailure(operation, "effect_agent_settlement_reservations", validated.submissionId, error.message)));
866
+ return ReservedSettlement.make({
867
+ submissionId: validated.submissionId,
868
+ settlementId: validated.settlementId,
869
+ outcome: validated.outcome,
870
+ record,
871
+ recordDigest: validated.recordDigest,
872
+ replayed: true
873
+ });
874
+ }
875
+ const submission = yield* requireSubmission(operation, validated.submissionId);
876
+ if (submission.state === "settled") {
877
+ if (submission.settled_outcome === null) return yield* corruptionFailure(operation, "effect_agent_submissions", validated.submissionId, "A settled Submission carries no terminal outcome.");
878
+ return yield* SettlementConflict.make({
879
+ submissionId: validated.submissionId,
880
+ existingOutcome: submission.settled_outcome
881
+ });
882
+ }
883
+ if (!(submission.state === "joined" && submission.joined_host_submission_id !== null)) {
884
+ let queuedAbortSettlement = false;
885
+ if (validated.outcome === "aborted" && (submission.state === "ready" || submission.state === "terminalizing")) {
886
+ const abortIntent = yield* readAbortIntent(operation, validated.submissionId);
887
+ if (Option.isSome(abortIntent)) {
888
+ const ownership = yield* readOwnership(operation, validated.submissionId);
889
+ queuedAbortSettlement = Option.isNone(ownership);
890
+ }
891
+ }
892
+ if (!queuedAbortSettlement) yield* requireOwnership(operation, submission, validated.ownershipToken);
893
+ }
894
+ const now = yield* currentInstant;
895
+ yield* sql`
896
+ INSERT INTO effect_agent_settlement_reservations (
897
+ submission_id,
898
+ settlement_id,
899
+ outcome,
900
+ record_id,
901
+ record_json,
902
+ record_digest,
903
+ reserved_at
904
+ ) VALUES (
905
+ ${validated.submissionId},
906
+ ${validated.settlementId},
907
+ ${validated.outcome},
908
+ ${validated.record.recordId},
909
+ ${recordJson},
910
+ ${validated.recordDigest},
911
+ ${now.iso}
912
+ )
913
+ `.pipe(Effect.mapError(sqlFailure(operation)));
914
+ yield* sql`
915
+ UPDATE effect_agent_submissions
916
+ SET state = 'terminalizing'
917
+ WHERE submission_id = ${validated.submissionId}
918
+ `.pipe(Effect.mapError(sqlFailure(operation)));
919
+ return ReservedSettlement.make({
920
+ submissionId: validated.submissionId,
921
+ settlementId: validated.settlementId,
922
+ outcome: validated.outcome,
923
+ record: validated.record,
924
+ recordDigest: validated.recordDigest,
925
+ replayed: false
926
+ });
927
+ }));
928
+ yield* hitFailpoint("ledger:reserve-settlement:after", operation);
929
+ return reserved;
930
+ });
931
+ const finalizeSettlement = Effect.fn("SqliteSubmissionLedger.finalizeSettlement")(function* (request) {
932
+ const operation = "ledger finalize settlement";
933
+ const validated = yield* Schema.decodeUnknownEffect(Schema.toType(SettlementFinalization))(request).pipe(Effect.mapError(internalFailure(operation)));
934
+ yield* hitFailpoint("ledger:finalize-settlement:before", operation);
935
+ const settlement = yield* inWriteTransaction(operation, Effect.gen(function* () {
936
+ const reservation = yield* readReservation(operation, validated.submissionId);
937
+ if (Option.isNone(reservation)) return yield* LedgerError.make({
938
+ operation,
939
+ message: `No settlement reservation exists for submission ${validated.submissionId}.`
940
+ });
941
+ if (reservation.value.settlement_id !== validated.settlementId) return yield* SettlementConflict.make({
942
+ submissionId: validated.submissionId,
943
+ existingOutcome: reservation.value.outcome
944
+ });
945
+ const reservationRecord = yield* decodeRecordEnvelopeText(reservation.value.record_json).pipe(Effect.mapError((error) => corruptionFailure(operation, "effect_agent_settlement_reservations", validated.submissionId, error.message)));
946
+ const settlementFailure = settlementFailureFromRecord(reservationRecord);
947
+ if (reservation.value.outcome === "failed" !== (settlementFailure !== void 0)) return yield* corruptionFailure(operation, "effect_agent_settlement_reservations", validated.submissionId, "The reserved outcome and canonical failure diagnostic disagree.");
948
+ const submission = yield* requireSubmission(operation, validated.submissionId);
949
+ if (submission.state === "settled") {
950
+ if (reservation.value.finalized_at === null) return yield* corruptionFailure(operation, "effect_agent_settlement_reservations", validated.submissionId, "A settled Submission's reservation carries no finalization timestamp.");
951
+ return yield* decodeSettlement({
952
+ submissionId: validated.submissionId,
953
+ settlementId: validated.settlementId,
954
+ receiptId: submission.receipt_id,
955
+ outcome: reservation.value.outcome,
956
+ ...settlementFailure === void 0 ? {} : { failure: settlementFailure },
957
+ settledAt: reservation.value.finalized_at
958
+ }).pipe(Effect.mapError(internalFailure(operation)));
959
+ }
960
+ const now = yield* currentInstant;
961
+ yield* sql`
962
+ UPDATE effect_agent_submissions
963
+ SET state = 'settled', settled_outcome = ${reservation.value.outcome}
964
+ WHERE submission_id = ${validated.submissionId}
965
+ `.pipe(Effect.mapError(sqlFailure(operation)));
966
+ yield* sql`
967
+ UPDATE effect_agent_settlement_reservations
968
+ SET finalized_at = ${now.iso}
969
+ WHERE submission_id = ${validated.submissionId}
970
+ `.pipe(Effect.mapError(sqlFailure(operation)));
971
+ yield* sql`
972
+ DELETE FROM effect_agent_submission_ownership
973
+ WHERE submission_id = ${validated.submissionId}
974
+ `.pipe(Effect.mapError(sqlFailure(operation)));
975
+ return yield* decodeSettlement({
976
+ submissionId: validated.submissionId,
977
+ settlementId: validated.settlementId,
978
+ receiptId: submission.receipt_id,
979
+ outcome: reservation.value.outcome,
980
+ ...settlementFailure === void 0 ? {} : { failure: settlementFailure },
981
+ settledAt: now.iso
982
+ }).pipe(Effect.mapError(internalFailure(operation)));
983
+ }));
984
+ yield* hitFailpoint("ledger:finalize-settlement:after", operation);
985
+ return settlement;
986
+ });
987
+ const requestAbort = Effect.fn("SqliteSubmissionLedger.requestAbort")(function* (request) {
988
+ const operation = "ledger request abort";
989
+ const validated = yield* Schema.decodeUnknownEffect(Schema.toType(AbortCommand))(request).pipe(Effect.mapError(internalFailure(operation)));
990
+ yield* hitFailpoint("ledger:request-abort:before", operation);
991
+ const intent = yield* inWriteTransaction(operation, Effect.gen(function* () {
992
+ const submission = yield* requireSubmission(operation, validated.submissionId);
993
+ if (submission.state === "settled") {
994
+ if (submission.settled_outcome === null) return yield* corruptionFailure(operation, "effect_agent_submissions", validated.submissionId, "A settled Submission carries no terminal outcome.");
995
+ return yield* SettlementConflict.make({
996
+ submissionId: validated.submissionId,
997
+ existingOutcome: submission.settled_outcome
998
+ });
999
+ }
1000
+ if (submission.state === "joined") {
1001
+ if (submission.joined_host_submission_id === null) return yield* corruptionFailure(operation, "effect_agent_submissions", validated.submissionId, "A joined Submission carries no host linkage.");
1002
+ const hostSubmissionId = yield* decodeSubmissionId(submission.joined_host_submission_id).pipe(Effect.mapError(internalFailure(operation)));
1003
+ return yield* JoinedToHost.make({
1004
+ submissionId: validated.submissionId,
1005
+ hostSubmissionId
1006
+ });
1007
+ }
1008
+ const existing = yield* readAbortIntent(operation, validated.submissionId);
1009
+ if (Option.isSome(existing)) return yield* abortIntentFromRow(operation, submission, validated.submissionId, existing.value);
1010
+ const now = yield* currentInstant;
1011
+ yield* sql`
1012
+ INSERT INTO effect_agent_abort_intents (
1013
+ submission_id,
1014
+ author,
1015
+ reason,
1016
+ requested_at
1017
+ ) VALUES (
1018
+ ${validated.submissionId},
1019
+ ${validated.author},
1020
+ ${validated.reason},
1021
+ ${now.iso}
1022
+ )
1023
+ `.pipe(Effect.mapError(sqlFailure(operation)));
1024
+ const canonicalRecordId = yield* canonicalAbortRecordId(operation, submission.thread_id, validated.submissionId);
1025
+ return yield* decodeAbortIntent({
1026
+ submissionId: validated.submissionId,
1027
+ author: validated.author,
1028
+ reason: validated.reason,
1029
+ requestedAt: now.iso,
1030
+ ...canonicalRecordId === void 0 ? {} : { canonicalRecordId }
1031
+ }).pipe(Effect.mapError(internalFailure(operation)));
1032
+ }));
1033
+ yield* hitFailpoint("ledger:request-abort:after", operation);
1034
+ return intent;
1035
+ });
1036
+ const claimJoining = Effect.fn("SqliteSubmissionLedger.claimJoining")(function* (request) {
1037
+ const operation = "ledger claim joining";
1038
+ const validated = yield* Schema.decodeUnknownEffect(Schema.toType(ClaimJoiningRequest))(request).pipe(Effect.mapError(internalFailure(operation)));
1039
+ yield* hitFailpoint("ledger:claim-joining:before", operation);
1040
+ const claims = yield* inWriteTransaction(operation, Effect.gen(function* () {
1041
+ const host = yield* requireSubmission(operation, validated.hostSubmissionId);
1042
+ if (host.thread_id !== validated.threadId) return yield* LedgerError.make({
1043
+ operation,
1044
+ message: `Host submission ${validated.hostSubmissionId} does not belong to thread ${validated.threadId}.`
1045
+ });
1046
+ yield* requireOwnership(operation, host, validated.ownershipToken);
1047
+ const laterRows = yield* sql`
1048
+ SELECT ${sql.literal(SUBMISSION_COLUMNS)}
1049
+ FROM effect_agent_submissions
1050
+ WHERE thread_id = ${validated.threadId}
1051
+ AND queue_sequence > ${host.queue_sequence}
1052
+ ORDER BY queue_sequence ASC
1053
+ `.pipe(Effect.mapError(sqlFailure(operation)));
1054
+ const later = yield* decodeSubmissionRows(operation, validated.threadId, laterRows);
1055
+ const claimed = [];
1056
+ for (const row of later) {
1057
+ if (claimed.length >= validated.maxCount) break;
1058
+ if ((row.state === "joining" || row.state === "joined") && row.joined_host_submission_id === validated.hostSubmissionId) continue;
1059
+ if (row.state === "settled" && row.settled_outcome === "aborted") continue;
1060
+ if (row.state !== "ready") break;
1061
+ yield* sql`
1062
+ UPDATE effect_agent_submissions
1063
+ SET state = 'joining', joined_host_submission_id = ${validated.hostSubmissionId}
1064
+ WHERE submission_id = ${row.submission_id}
1065
+ `.pipe(Effect.mapError(sqlFailure(operation)));
1066
+ const inputPayload = yield* parseStoredJsonText(row.input_json).pipe(Effect.mapError((error) => corruptionFailure(operation, "effect_agent_submissions", row.submission_id, error.message)));
1067
+ claimed.push(yield* decodeJoiningClaim({
1068
+ submissionId: row.submission_id,
1069
+ queueSequence: row.queue_sequence,
1070
+ inputPayload
1071
+ }).pipe(Effect.mapError(internalFailure(operation))));
1072
+ }
1073
+ return claimed;
1074
+ }));
1075
+ yield* hitFailpoint("ledger:claim-joining:after", operation);
1076
+ return claims;
1077
+ });
1078
+ const markJoined = Effect.fn("SqliteSubmissionLedger.markJoined")(function* (request) {
1079
+ const operation = "ledger mark joined";
1080
+ const validated = yield* Schema.decodeUnknownEffect(Schema.toType(MarkJoinedRequest))(request).pipe(Effect.mapError(internalFailure(operation)));
1081
+ yield* hitFailpoint("ledger:mark-joined:before", operation);
1082
+ yield* inWriteTransaction(operation, Effect.gen(function* () {
1083
+ const submission = yield* requireSubmission(operation, validated.submissionId);
1084
+ if (submission.joined_host_submission_id === null) return yield* LedgerError.make({
1085
+ operation,
1086
+ message: `Submission ${validated.submissionId} was never claimed for joining.`
1087
+ });
1088
+ const host = yield* requireSubmission(operation, submission.joined_host_submission_id);
1089
+ yield* requireOwnership(operation, host, validated.ownershipToken);
1090
+ if (submission.input_applied_record_id !== null) {
1091
+ if (submission.input_applied_record_id === validated.recordId && submission.input_applied_sequence === validated.sequence) return;
1092
+ return yield* corruptionFailure(operation, "effect_agent_submissions", validated.submissionId, "A different join marker is already recorded for this Submission.");
1093
+ }
1094
+ if (submission.state !== "joining" && submission.state !== "joined") return yield* LedgerError.make({
1095
+ operation,
1096
+ message: `Cannot mark submission ${validated.submissionId} joined from state ${submission.state}.`
1097
+ });
1098
+ yield* sql`
1099
+ UPDATE effect_agent_submissions
1100
+ SET
1101
+ input_applied_record_id = ${validated.recordId},
1102
+ input_applied_sequence = ${validated.sequence},
1103
+ state = 'joined'
1104
+ WHERE submission_id = ${validated.submissionId}
1105
+ `.pipe(Effect.mapError(sqlFailure(operation)));
1106
+ }));
1107
+ yield* hitFailpoint("ledger:mark-joined:after", operation);
1108
+ });
1109
+ const revertJoining = Effect.fn("SqliteSubmissionLedger.revertJoining")(function* (request) {
1110
+ const operation = "ledger revert joining";
1111
+ const validated = yield* Schema.decodeUnknownEffect(Schema.toType(RevertJoiningRequest))(request).pipe(Effect.mapError(internalFailure(operation)));
1112
+ yield* hitFailpoint("ledger:revert-joining:before", operation);
1113
+ yield* inWriteTransaction(operation, Effect.gen(function* () {
1114
+ if ((yield* requireSubmission(operation, validated.submissionId)).state !== "joining") return;
1115
+ yield* sql`
1116
+ UPDATE effect_agent_submissions
1117
+ SET state = 'ready', joined_host_submission_id = NULL
1118
+ WHERE submission_id = ${validated.submissionId}
1119
+ `.pipe(Effect.mapError(sqlFailure(operation)));
1120
+ }));
1121
+ yield* hitFailpoint("ledger:revert-joining:after", operation);
1122
+ });
1123
+ const suspend = Effect.fn("SqliteSubmissionLedger.suspend")(function* (request) {
1124
+ const operation = "ledger suspend";
1125
+ const validated = yield* Schema.decodeUnknownEffect(Schema.toType(SuspendRequest))(request).pipe(Effect.mapError(internalFailure(operation)));
1126
+ const reasonJson = yield* encodeSuspensionReasonText(validated.reason).pipe(Effect.mapError(internalFailure(operation)));
1127
+ yield* hitFailpoint("ledger:suspend:before", operation);
1128
+ const outcome = yield* inWriteTransaction(operation, Effect.gen(function* () {
1129
+ const submission = yield* requireSubmission(operation, validated.submissionId);
1130
+ if (submission.state === "settled") {
1131
+ if (submission.settled_outcome === null) return yield* corruptionFailure(operation, "effect_agent_submissions", validated.submissionId, "A settled Submission carries no terminal outcome.");
1132
+ return yield* SettlementConflict.make({
1133
+ submissionId: validated.submissionId,
1134
+ existingOutcome: submission.settled_outcome
1135
+ });
1136
+ }
1137
+ const reservation = yield* readReservation(operation, validated.submissionId);
1138
+ if (Option.isSome(reservation)) return yield* SettlementConflict.make({
1139
+ submissionId: validated.submissionId,
1140
+ existingOutcome: reservation.value.outcome
1141
+ });
1142
+ yield* requireOwnership(operation, submission, validated.ownershipToken);
1143
+ if (validated.reason._tag === "ApprovalPending") {
1144
+ const decisions = yield* readApprovalDecisions(operation, validated.submissionId);
1145
+ const decided = new Set(decisions.map((row) => row.tool_call_id));
1146
+ if (validated.reason.toolCallIds.every((toolCallId) => decided.has(toolCallId))) return RESUME_IMMEDIATELY;
1147
+ } else {
1148
+ let allSettled = true;
1149
+ for (const child of validated.reason.children) {
1150
+ const childRow = yield* readSubmission(operation, child.childSubmissionId);
1151
+ if (Option.isNone(childRow) || childRow.value.state !== "settled") {
1152
+ allSettled = false;
1153
+ break;
1154
+ }
1155
+ }
1156
+ if (allSettled) return RESUME_IMMEDIATELY;
1157
+ }
1158
+ const now = yield* currentInstant;
1159
+ yield* sql`
1160
+ UPDATE effect_agent_submissions
1161
+ SET
1162
+ state = 'suspended',
1163
+ suspended_reason_json = ${reasonJson},
1164
+ suspended_at = ${now.iso}
1165
+ WHERE submission_id = ${validated.submissionId}
1166
+ `.pipe(Effect.mapError(sqlFailure(operation)));
1167
+ yield* sql`
1168
+ DELETE FROM effect_agent_submission_ownership
1169
+ WHERE submission_id = ${validated.submissionId}
1170
+ `.pipe(Effect.mapError(sqlFailure(operation)));
1171
+ return SUSPENDED;
1172
+ }));
1173
+ yield* hitFailpoint("ledger:suspend:after", operation);
1174
+ return outcome;
1175
+ });
1176
+ /**
1177
+ * Once every pending call of a recorded ApprovalPending suspension has a decision intent,
1178
+ * the lane wakes: suspended → input-applied, suspension cleared (plan §2.6). A
1179
+ * WaitingForChild suspension wakes only through recordChildSettled. Runs inside the caller's
1180
+ * write transaction.
1181
+ */
1182
+ const wakeSuspendedIfCovered = Effect.fn("SqliteSubmissionLedger.wakeSuspendedIfCovered")(function* (operation, submission) {
1183
+ if (submission.state !== "suspended" || submission.suspended_reason_json === null) return;
1184
+ const reason = yield* Schema.decodeEffect(Schema.fromJsonString(SuspensionReason))(submission.suspended_reason_json).pipe(Effect.mapError((error) => corruptionFailure(operation, "effect_agent_submissions", submission.submission_id, error.message)));
1185
+ if (reason._tag !== "ApprovalPending") return;
1186
+ const decisions = yield* readApprovalDecisions(operation, submission.submission_id);
1187
+ const decided = new Set(decisions.map((row) => row.tool_call_id));
1188
+ if (!reason.toolCallIds.every((toolCallId) => decided.has(toolCallId))) return;
1189
+ yield* sql`
1190
+ UPDATE effect_agent_submissions
1191
+ SET
1192
+ state = 'input-applied',
1193
+ suspended_reason_json = NULL,
1194
+ suspended_at = NULL
1195
+ WHERE submission_id = ${submission.submission_id}
1196
+ `.pipe(Effect.mapError(sqlFailure(operation)));
1197
+ });
1198
+ const recordApprovalDecision = Effect.fn("SqliteSubmissionLedger.recordApprovalDecision")(function* (command) {
1199
+ const operation = "ledger record approval decision";
1200
+ const validated = yield* Schema.decodeUnknownEffect(Schema.toType(ApprovalDecisionCommand))(command).pipe(Effect.mapError(internalFailure(operation)));
1201
+ yield* hitFailpoint("ledger:approval-decision:before", operation);
1202
+ const intent = yield* inWriteTransaction(operation, Effect.gen(function* () {
1203
+ const submission = yield* requireSubmission(operation, validated.submissionId);
1204
+ if (submission.state === "settled") {
1205
+ if (submission.settled_outcome === null) return yield* corruptionFailure(operation, "effect_agent_submissions", validated.submissionId, "A settled Submission carries no terminal outcome.");
1206
+ return yield* SettlementConflict.make({
1207
+ submissionId: validated.submissionId,
1208
+ existingOutcome: submission.settled_outcome
1209
+ });
1210
+ }
1211
+ const existing = (yield* readApprovalDecisions(operation, validated.submissionId)).find((row) => row.tool_call_id === validated.toolCallId);
1212
+ if (existing !== void 0) {
1213
+ if (existing.decision !== validated.decision) return yield* ApprovalConflict.make({
1214
+ submissionId: validated.submissionId,
1215
+ toolCallId: validated.toolCallId,
1216
+ existingDecision: existing.decision
1217
+ });
1218
+ return yield* approvalIntentFromRow(operation, existing);
1219
+ }
1220
+ const now = yield* currentInstant;
1221
+ yield* sql`
1222
+ INSERT INTO effect_agent_approval_decisions (
1223
+ submission_id,
1224
+ tool_call_id,
1225
+ decision,
1226
+ resolver,
1227
+ reason,
1228
+ decided_at
1229
+ ) VALUES (
1230
+ ${validated.submissionId},
1231
+ ${validated.toolCallId},
1232
+ ${validated.decision},
1233
+ ${validated.resolver},
1234
+ ${validated.reason},
1235
+ ${now.iso}
1236
+ )
1237
+ `.pipe(Effect.mapError(sqlFailure(operation)));
1238
+ yield* wakeSuspendedIfCovered(operation, submission);
1239
+ return yield* decodeApprovalDecisionIntent({
1240
+ submissionId: validated.submissionId,
1241
+ toolCallId: validated.toolCallId,
1242
+ decision: validated.decision,
1243
+ resolver: validated.resolver,
1244
+ reason: validated.reason,
1245
+ decidedAt: now.iso
1246
+ }).pipe(Effect.mapError(internalFailure(operation)));
1247
+ }));
1248
+ yield* hitFailpoint("ledger:approval-decision:after", operation);
1249
+ return intent;
1250
+ });
1251
+ const markUnknown = Effect.fn("SqliteSubmissionLedger.markUnknown")(function* (request) {
1252
+ const operation = "ledger mark unknown";
1253
+ const validated = yield* Schema.decodeUnknownEffect(Schema.toType(MarkUnknownRequest))(request).pipe(Effect.mapError(internalFailure(operation)));
1254
+ yield* hitFailpoint("ledger:mark-unknown:before", operation);
1255
+ yield* inWriteTransaction(operation, Effect.gen(function* () {
1256
+ const submission = yield* requireSubmission(operation, validated.submissionId);
1257
+ if (submission.state === "settled") {
1258
+ if (submission.settled_outcome === null) return yield* corruptionFailure(operation, "effect_agent_submissions", validated.submissionId, "A settled Submission carries no terminal outcome.");
1259
+ return yield* SettlementConflict.make({
1260
+ submissionId: validated.submissionId,
1261
+ existingOutcome: submission.settled_outcome
1262
+ });
1263
+ }
1264
+ const reservation = yield* readReservation(operation, validated.submissionId);
1265
+ if (Option.isSome(reservation)) return yield* SettlementConflict.make({
1266
+ submissionId: validated.submissionId,
1267
+ existingOutcome: reservation.value.outcome
1268
+ });
1269
+ const existingIds = yield* storedUnknownToolCallIds(operation, submission);
1270
+ const known = new Set(existingIds);
1271
+ const merged = [...existingIds, ...validated.toolCallIds.filter((toolCallId) => !known.has(toolCallId))];
1272
+ const idsJson = yield* encodeToolCallIdsText(merged).pipe(Effect.mapError(internalFailure(operation)));
1273
+ yield* sql`
1274
+ UPDATE effect_agent_submissions
1275
+ SET
1276
+ state = 'unknown',
1277
+ unknown_reason = ${submission.unknown_reason ?? validated.reason},
1278
+ unknown_tool_call_ids_json = ${idsJson}
1279
+ WHERE submission_id = ${validated.submissionId}
1280
+ `.pipe(Effect.mapError(sqlFailure(operation)));
1281
+ }));
1282
+ yield* hitFailpoint("ledger:mark-unknown:after", operation);
1283
+ });
1284
+ const recordUnknownResolution = Effect.fn("SqliteSubmissionLedger.recordUnknownResolution")(function* (command) {
1285
+ const operation = "ledger record unknown resolution";
1286
+ const validated = yield* Schema.decodeUnknownEffect(Schema.toType(UnknownResolutionCommand))(command).pipe(Effect.mapError(internalFailure(operation)));
1287
+ const resolutionJson = yield* encodeUnknownResolutionText(validated.resolution).pipe(Effect.mapError(internalFailure(operation)));
1288
+ yield* hitFailpoint("ledger:unknown-resolution:before", operation);
1289
+ const intent = yield* inWriteTransaction(operation, Effect.gen(function* () {
1290
+ const submission = yield* requireSubmission(operation, validated.submissionId);
1291
+ if (submission.state === "settled") {
1292
+ if (submission.settled_outcome === null) return yield* corruptionFailure(operation, "effect_agent_submissions", validated.submissionId, "A settled Submission carries no terminal outcome.");
1293
+ return yield* SettlementConflict.make({
1294
+ submissionId: validated.submissionId,
1295
+ existingOutcome: submission.settled_outcome
1296
+ });
1297
+ }
1298
+ const existing = (yield* readUnknownResolutions(operation, validated.submissionId)).find((row) => row.tool_call_id === validated.toolCallId);
1299
+ const existingIntent = existing === void 0 ? void 0 : yield* unknownResolutionIntentFromRow(operation, existing);
1300
+ if (existingIntent !== void 0 && !equivalentUnknownResolution(existingIntent.resolution, validated.resolution)) return yield* UnknownResolutionConflict.make({
1301
+ submissionId: validated.submissionId,
1302
+ toolCallId: validated.toolCallId
1303
+ });
1304
+ let resolved;
1305
+ if (existingIntent !== void 0) resolved = existingIntent;
1306
+ else {
1307
+ const now = yield* currentInstant;
1308
+ yield* sql`
1309
+ INSERT INTO effect_agent_unknown_resolutions (
1310
+ submission_id,
1311
+ tool_call_id,
1312
+ author,
1313
+ reason,
1314
+ resolution_json,
1315
+ resolved_at
1316
+ ) VALUES (
1317
+ ${validated.submissionId},
1318
+ ${validated.toolCallId},
1319
+ ${validated.author},
1320
+ ${validated.reason},
1321
+ ${resolutionJson},
1322
+ ${now.iso}
1323
+ )
1324
+ `.pipe(Effect.mapError(sqlFailure(operation)));
1325
+ const resolution = yield* parseStoredJsonText(resolutionJson).pipe(Effect.mapError(internalFailure(operation)));
1326
+ resolved = yield* decodeUnknownResolutionIntent({
1327
+ submissionId: validated.submissionId,
1328
+ toolCallId: validated.toolCallId,
1329
+ author: validated.author,
1330
+ reason: validated.reason,
1331
+ resolution,
1332
+ resolvedAt: now.iso
1333
+ }).pipe(Effect.mapError(internalFailure(operation)));
1334
+ }
1335
+ if (submission.state === "unknown" && submission.unknown_tool_call_ids_json !== null) {
1336
+ const markedIds = yield* storedUnknownToolCallIds(operation, submission);
1337
+ const covering = yield* readUnknownResolutions(operation, validated.submissionId);
1338
+ const coveredIds = new Set(covering.map((row) => row.tool_call_id));
1339
+ if (markedIds.every((toolCallId) => coveredIds.has(toolCallId))) yield* sql`
1340
+ UPDATE effect_agent_submissions
1341
+ SET
1342
+ state = 'input-applied',
1343
+ unknown_reason = NULL,
1344
+ unknown_tool_call_ids_json = NULL
1345
+ WHERE submission_id = ${validated.submissionId}
1346
+ `.pipe(Effect.mapError(sqlFailure(operation)));
1347
+ }
1348
+ return resolved;
1349
+ }));
1350
+ yield* hitFailpoint("ledger:unknown-resolution:after", operation);
1351
+ return intent;
1352
+ });
1353
+ const recordChildSettled = Effect.fn("SqliteSubmissionLedger.recordChildSettled")(function* (request) {
1354
+ const operation = "ledger record child settled";
1355
+ const validated = yield* Schema.decodeUnknownEffect(Schema.toType(ChildSettledNotification))(request).pipe(Effect.mapError(internalFailure(operation)));
1356
+ yield* hitFailpoint("ledger:child-settled:before", operation);
1357
+ const outcome = yield* inWriteTransaction(operation, Effect.gen(function* () {
1358
+ const parent = yield* requireSubmission(operation, validated.parentSubmissionId);
1359
+ const child = yield* readSubmission(operation, validated.childSubmissionId);
1360
+ const childReservation = yield* readReservation(operation, validated.childSubmissionId);
1361
+ if (!(Option.isSome(child) && (child.value.state === "settled" || child.value.state === "terminalizing" && Option.isSome(childReservation)))) return yield* LedgerError.make({
1362
+ operation,
1363
+ message: `Child submission ${validated.childSubmissionId} has no recorded settlement.`
1364
+ });
1365
+ if (parent.state !== "suspended" || parent.suspended_reason_json === null) return NOT_WAITING;
1366
+ const reason = yield* Schema.decodeEffect(Schema.fromJsonString(SuspensionReason))(parent.suspended_reason_json).pipe(Effect.mapError((error) => corruptionFailure(operation, "effect_agent_submissions", parent.submission_id, error.message)));
1367
+ if (reason._tag !== "WaitingForChild") return NOT_WAITING;
1368
+ if (!reason.children.some((entry) => entry.childSubmissionId === validated.childSubmissionId)) return NOT_WAITING;
1369
+ for (const entry of reason.children) {
1370
+ const listed = yield* readSubmission(operation, entry.childSubmissionId);
1371
+ const reservation = yield* readReservation(operation, entry.childSubmissionId);
1372
+ if (!(Option.isSome(listed) && (listed.value.state === "settled" || listed.value.state === "terminalizing" && Option.isSome(reservation)))) return STILL_WAITING;
1373
+ }
1374
+ yield* sql`
1375
+ UPDATE effect_agent_submissions
1376
+ SET
1377
+ state = 'input-applied',
1378
+ suspended_reason_json = NULL,
1379
+ suspended_at = NULL
1380
+ WHERE submission_id = ${validated.parentSubmissionId}
1381
+ `.pipe(Effect.mapError(sqlFailure(operation)));
1382
+ return WOKEN;
1383
+ }));
1384
+ yield* hitFailpoint("ledger:child-settled:after", operation);
1385
+ return outcome;
1386
+ });
1387
+ const reserveChildBudget = Effect.fn("SqliteSubmissionLedger.reserveChildBudget")(function* (request) {
1388
+ const operation = "ledger reserve child budget";
1389
+ const validated = yield* Schema.decodeUnknownEffect(Schema.toType(ChildBudgetReservationRequest))(request).pipe(Effect.mapError(internalFailure(operation)));
1390
+ const allocationJson = yield* encodePersistedJsonText(validated.allocation).pipe(Effect.mapError(internalFailure(operation)));
1391
+ yield* hitFailpoint("ledger:child-reservation:before", operation);
1392
+ const reserved = yield* inWriteTransaction(operation, Effect.gen(function* () {
1393
+ const existing = yield* readChildReservation(operation, validated.reservationId);
1394
+ if (Option.isSome(existing)) {
1395
+ const existingSnapshot = yield* childReservationSnapshotFromRow(operation, existing.value);
1396
+ if (!(existing.value.parent_submission_id === validated.parentSubmissionId && existing.value.parent_tool_call_id === validated.parentToolCallId && existing.value.allocation_digest === validated.allocationDigest && equivalentPersistedJson(existingSnapshot.allocation, validated.allocation))) return yield* ChildReservationConflict.make({
1397
+ reservationId: validated.reservationId,
1398
+ status: existing.value.status,
1399
+ message: "A reservation with this identity exists with a different parent Tool Call or allocation."
1400
+ });
1401
+ return ReservedChildBudget.make({
1402
+ reservation: existingSnapshot,
1403
+ replayed: true
1404
+ });
1405
+ }
1406
+ const collision = yield* readChildReservationForCall(operation, validated.parentSubmissionId, validated.parentToolCallId);
1407
+ if (Option.isSome(collision)) return yield* ChildReservationConflict.make({
1408
+ reservationId: validated.reservationId,
1409
+ status: collision.value.status,
1410
+ message: `Parent Tool Call ${validated.parentToolCallId} already owns reservation ${collision.value.reservation_id}.`
1411
+ });
1412
+ const parent = yield* requireSubmission(operation, validated.parentSubmissionId);
1413
+ yield* requireOwnership(operation, parent, validated.ownershipToken);
1414
+ const now = yield* currentInstant;
1415
+ yield* sql`
1416
+ INSERT INTO effect_agent_child_reservations (
1417
+ reservation_id,
1418
+ parent_submission_id,
1419
+ parent_tool_call_id,
1420
+ status,
1421
+ allocation_json,
1422
+ allocation_digest,
1423
+ reserved_at
1424
+ ) VALUES (
1425
+ ${validated.reservationId},
1426
+ ${validated.parentSubmissionId},
1427
+ ${validated.parentToolCallId},
1428
+ 'reserved',
1429
+ ${allocationJson},
1430
+ ${validated.allocationDigest},
1431
+ ${now.iso}
1432
+ )
1433
+ `.pipe(Effect.mapError(sqlFailure(operation)));
1434
+ const inserted = yield* readChildReservation(operation, validated.reservationId);
1435
+ if (Option.isNone(inserted)) return yield* corruptionFailure(operation, "effect_agent_child_reservations", validated.reservationId, "An inserted child reservation row is missing inside its own transaction.");
1436
+ return ReservedChildBudget.make({
1437
+ reservation: yield* childReservationSnapshotFromRow(operation, inserted.value),
1438
+ replayed: false
1439
+ });
1440
+ }));
1441
+ yield* hitFailpoint("ledger:child-reservation:after", operation);
1442
+ return reserved;
1443
+ });
1444
+ const attachChildToReservation = Effect.fn("SqliteSubmissionLedger.attachChildToReservation")(function* (request) {
1445
+ const operation = "ledger attach child to reservation";
1446
+ const validated = yield* Schema.decodeUnknownEffect(Schema.toType(AttachChildToReservationRequest))(request).pipe(Effect.mapError(internalFailure(operation)));
1447
+ yield* hitFailpoint("ledger:child-attach:before", operation);
1448
+ const attached = yield* inWriteTransaction(operation, Effect.gen(function* () {
1449
+ const existing = yield* readChildReservation(operation, validated.reservationId);
1450
+ if (Option.isNone(existing)) return yield* LedgerError.make({
1451
+ operation,
1452
+ message: `Unknown child reservation ${validated.reservationId}.`
1453
+ });
1454
+ if (existing.value.child_submission_id !== null) {
1455
+ if (existing.value.child_submission_id === validated.childSubmissionId) return yield* childReservationSnapshotFromRow(operation, existing.value);
1456
+ return yield* ChildReservationConflict.make({
1457
+ reservationId: validated.reservationId,
1458
+ status: existing.value.status,
1459
+ message: `Reservation ${validated.reservationId} already records child ${existing.value.child_submission_id}.`
1460
+ });
1461
+ }
1462
+ const parent = yield* requireSubmission(operation, existing.value.parent_submission_id);
1463
+ yield* requireOwnership(operation, parent, validated.ownershipToken);
1464
+ if (existing.value.status !== "reserved") return yield* ChildReservationConflict.make({
1465
+ reservationId: validated.reservationId,
1466
+ status: existing.value.status,
1467
+ message: `Cannot attach a child to a ${existing.value.status} reservation.`
1468
+ });
1469
+ const child = yield* readSubmission(operation, validated.childSubmissionId);
1470
+ if (Option.isNone(child)) return yield* LedgerError.make({
1471
+ operation,
1472
+ message: `Unknown child submission ${validated.childSubmissionId}.`
1473
+ });
1474
+ yield* sql`
1475
+ UPDATE effect_agent_child_reservations
1476
+ SET child_submission_id = ${validated.childSubmissionId}
1477
+ WHERE reservation_id = ${validated.reservationId}
1478
+ `.pipe(Effect.mapError(sqlFailure(operation)));
1479
+ const updated = yield* readChildReservation(operation, validated.reservationId);
1480
+ if (Option.isNone(updated)) return yield* corruptionFailure(operation, "effect_agent_child_reservations", validated.reservationId, "An updated child reservation row is missing inside its own transaction.");
1481
+ return yield* childReservationSnapshotFromRow(operation, updated.value);
1482
+ }));
1483
+ yield* hitFailpoint("ledger:child-attach:after", operation);
1484
+ return attached;
1485
+ });
1486
+ const beginChildBudgetRelease = Effect.fn("SqliteSubmissionLedger.beginChildBudgetRelease")(function* (request) {
1487
+ const operation = "ledger begin child budget release";
1488
+ const validated = yield* Schema.decodeUnknownEffect(Schema.toType(BeginChildBudgetReleaseRequest))(request).pipe(Effect.mapError(internalFailure(operation)));
1489
+ const accountingJson = yield* encodePersistedJsonText(validated.accounting).pipe(Effect.mapError(internalFailure(operation)));
1490
+ yield* hitFailpoint("ledger:child-release-pending:before", operation);
1491
+ const frozen = yield* inWriteTransaction(operation, Effect.gen(function* () {
1492
+ const existing = yield* readChildReservation(operation, validated.reservationId);
1493
+ if (Option.isNone(existing)) return yield* LedgerError.make({
1494
+ operation,
1495
+ message: `Unknown child reservation ${validated.reservationId}.`
1496
+ });
1497
+ if (existing.value.status !== "reserved") {
1498
+ const existingSnapshot = yield* childReservationSnapshotFromRow(operation, existing.value);
1499
+ if (existingSnapshot.accounting !== void 0 && equivalentPersistedJson(existingSnapshot.accounting, validated.accounting)) return existingSnapshot;
1500
+ return yield* ChildReservationConflict.make({
1501
+ reservationId: validated.reservationId,
1502
+ status: existing.value.status,
1503
+ message: "A different accounting decision is already frozen for this reservation."
1504
+ });
1505
+ }
1506
+ const now = yield* currentInstant;
1507
+ yield* sql`
1508
+ UPDATE effect_agent_child_reservations
1509
+ SET
1510
+ status = 'releasePending',
1511
+ accounting_json = ${accountingJson},
1512
+ release_began_at = ${now.iso}
1513
+ WHERE reservation_id = ${validated.reservationId}
1514
+ `.pipe(Effect.mapError(sqlFailure(operation)));
1515
+ const updated = yield* readChildReservation(operation, validated.reservationId);
1516
+ if (Option.isNone(updated)) return yield* corruptionFailure(operation, "effect_agent_child_reservations", validated.reservationId, "An updated child reservation row is missing inside its own transaction.");
1517
+ return yield* childReservationSnapshotFromRow(operation, updated.value);
1518
+ }));
1519
+ yield* hitFailpoint("ledger:child-release-pending:after", operation);
1520
+ return frozen;
1521
+ });
1522
+ const releaseChildBudget = Effect.fn("SqliteSubmissionLedger.releaseChildBudget")(function* (request) {
1523
+ const operation = "ledger release child budget";
1524
+ const validated = yield* Schema.decodeUnknownEffect(Schema.toType(ReleaseChildBudgetRequest))(request).pipe(Effect.mapError(internalFailure(operation)));
1525
+ yield* hitFailpoint("ledger:child-release:before", operation);
1526
+ const released = yield* inWriteTransaction(operation, Effect.gen(function* () {
1527
+ const existing = yield* readChildReservation(operation, validated.reservationId);
1528
+ if (Option.isNone(existing)) return yield* LedgerError.make({
1529
+ operation,
1530
+ message: `Unknown child reservation ${validated.reservationId}.`
1531
+ });
1532
+ if (existing.value.status === "released") return yield* childReservationSnapshotFromRow(operation, existing.value);
1533
+ if (existing.value.status !== "releasePending") return yield* ChildReservationConflict.make({
1534
+ reservationId: validated.reservationId,
1535
+ status: existing.value.status,
1536
+ message: "Cannot release a reservation whose accounting decision is not frozen."
1537
+ });
1538
+ const now = yield* currentInstant;
1539
+ yield* sql`
1540
+ UPDATE effect_agent_child_reservations
1541
+ SET status = 'released', released_at = ${now.iso}
1542
+ WHERE reservation_id = ${validated.reservationId}
1543
+ `.pipe(Effect.mapError(sqlFailure(operation)));
1544
+ const updated = yield* readChildReservation(operation, validated.reservationId);
1545
+ if (Option.isNone(updated)) return yield* corruptionFailure(operation, "effect_agent_child_reservations", validated.reservationId, "An updated child reservation row is missing inside its own transaction.");
1546
+ return yield* childReservationSnapshotFromRow(operation, updated.value);
1547
+ }));
1548
+ yield* hitFailpoint("ledger:child-release:after", operation);
1549
+ return released;
1550
+ });
1551
+ const scanPage = Effect.fn("SqliteSubmissionLedger.scanPage")(function* (cursor) {
1552
+ const operation = "ledger scan nonterminal";
1553
+ const rows = yield* (cursor === void 0 ? sql`
1554
+ SELECT ${sql.literal(SUBMISSION_COLUMNS)}
1555
+ FROM effect_agent_submissions
1556
+ WHERE state <> 'settled'
1557
+ ORDER BY thread_id ASC, queue_sequence ASC
1558
+ LIMIT ${SCAN_PAGE_SIZE}
1559
+ ` : sql`
1560
+ SELECT ${sql.literal(SUBMISSION_COLUMNS)}
1561
+ FROM effect_agent_submissions
1562
+ WHERE state <> 'settled'
1563
+ AND (
1564
+ thread_id > ${cursor.threadId}
1565
+ OR (
1566
+ thread_id = ${cursor.threadId}
1567
+ AND queue_sequence > ${cursor.queueSequence}
1568
+ )
1569
+ )
1570
+ ORDER BY thread_id ASC, queue_sequence ASC
1571
+ LIMIT ${SCAN_PAGE_SIZE}
1572
+ `).pipe(Effect.mapError(sqlFailure(operation)));
1573
+ const decoded = yield* decodeSubmissionRows(operation, "nonterminal_scan", rows);
1574
+ const snapshots = yield* Effect.forEach(decoded, (row) => decodeSubmissionSnapshot(operation, row));
1575
+ const last = decoded[decoded.length - 1];
1576
+ return [snapshots, last === void 0 || decoded.length < SCAN_PAGE_SIZE ? Option.none() : Option.some({
1577
+ threadId: last.thread_id,
1578
+ queueSequence: last.queue_sequence
1579
+ })];
1580
+ });
1581
+ const scanNonterminal = Stream.paginate(void 0, scanPage);
1582
+ const readAbortIntentForSubmission = Effect.fn("SqliteSubmissionLedger.readAbortIntentForSubmission")(function* (request) {
1583
+ const operation = "ledger read abort intent";
1584
+ const validated = yield* Schema.decodeUnknownEffect(Schema.toType(AbortIntentRequest))(request).pipe(Effect.mapError(internalFailure(operation)));
1585
+ const recordId = submissionAbortRecordId(validated.submissionId);
1586
+ const rows = yield* sql`
1587
+ SELECT
1588
+ submission.submission_id,
1589
+ abort.submission_id AS abort_submission_id,
1590
+ abort.author,
1591
+ abort.reason,
1592
+ abort.requested_at,
1593
+ canonical.record_id AS canonical_record_id
1594
+ FROM effect_agent_submissions AS submission
1595
+ LEFT JOIN effect_agent_abort_intents AS abort
1596
+ ON abort.submission_id = submission.submission_id
1597
+ LEFT JOIN effect_agent_canonical_records AS canonical
1598
+ ON canonical.thread_id = submission.thread_id
1599
+ AND canonical.record_id = ${recordId}
1600
+ WHERE submission.submission_id = ${validated.submissionId}
1601
+ `.pipe(Effect.mapError(sqlFailure(operation)));
1602
+ const decoded = yield* decodeRows(Schema.Array(AbortIntentLookupRow), "effect_agent_abort_intents", validated.submissionId, rows).pipe(Effect.mapError(internalFailure(operation)));
1603
+ if (decoded.length === 0) return yield* LedgerError.make({
1604
+ operation,
1605
+ message: `Unknown submission ${validated.submissionId}.`
1606
+ });
1607
+ if (decoded.length !== 1) return yield* corruptionFailure(operation, "effect_agent_abort_intents", validated.submissionId, "An abort intent lookup returned more than one row.");
1608
+ const row = decoded[0];
1609
+ if (row.abort_submission_id === null) return void 0;
1610
+ return yield* decodeAbortIntent({
1611
+ submissionId: row.abort_submission_id,
1612
+ author: row.author,
1613
+ reason: row.reason,
1614
+ requestedAt: row.requested_at,
1615
+ ...row.canonical_record_id === null ? {} : { canonicalRecordId: row.canonical_record_id }
1616
+ }).pipe(Effect.mapError((error) => corruptionFailure(operation, "effect_agent_abort_intents", validated.submissionId, error.message)));
1617
+ });
1618
+ const loadRecoverySnapshot = Effect.fn("SqliteSubmissionLedger.loadRecoverySnapshot")(function* (request) {
1619
+ const operation = "ledger load recovery snapshot";
1620
+ const validated = yield* Schema.decodeUnknownEffect(Schema.toType(RecoverySnapshotRequest))(request).pipe(Effect.mapError(internalFailure(operation)));
1621
+ return yield* journal.withReadTransaction(operation)(Effect.gen(function* () {
1622
+ const submissionRow = yield* requireSubmission(operation, validated.submissionId);
1623
+ const submission = yield* decodeSubmissionSnapshot(operation, submissionRow);
1624
+ let ownership;
1625
+ const ownershipRow = yield* readOwnership(operation, validated.submissionId);
1626
+ if (Option.isSome(ownershipRow)) ownership = yield* decodeOwnershipSnapshot({
1627
+ attemptId: ownershipRow.value.attempt_id,
1628
+ ownerProducerId: ownershipRow.value.owner_producer_id,
1629
+ producerEpoch: ownershipRow.value.producer_epoch,
1630
+ leaseExpiresAt: ownershipRow.value.lease_expires_at
1631
+ }).pipe(Effect.mapError(internalFailure(operation)));
1632
+ let inputApplied;
1633
+ if (submissionRow.input_applied_record_id !== null && submissionRow.input_applied_sequence !== null) inputApplied = yield* decodeInputAppliedMarker({
1634
+ recordId: submissionRow.input_applied_record_id,
1635
+ sequence: submissionRow.input_applied_sequence
1636
+ }).pipe(Effect.mapError(internalFailure(operation)));
1637
+ let reservation;
1638
+ const reservationRow = yield* readReservation(operation, validated.submissionId);
1639
+ if (Option.isSome(reservationRow)) {
1640
+ const record = yield* decodeRecordEnvelopeText(reservationRow.value.record_json).pipe(Effect.mapError((error) => corruptionFailure(operation, "effect_agent_settlement_reservations", validated.submissionId, error.message)));
1641
+ const settlementId = yield* Schema.decodeUnknownEffect(SettlementReservationSnapshot.fields.settlementId)(reservationRow.value.settlement_id).pipe(Effect.mapError(internalFailure(operation)));
1642
+ reservation = SettlementReservationSnapshot.make({
1643
+ settlementId,
1644
+ outcome: reservationRow.value.outcome,
1645
+ record,
1646
+ recordDigest: reservationRow.value.record_digest,
1647
+ finalized: reservationRow.value.finalized_at !== null
1648
+ });
1649
+ }
1650
+ let abortIntent;
1651
+ const abortRow = yield* readAbortIntent(operation, validated.submissionId);
1652
+ if (Option.isSome(abortRow)) abortIntent = yield* abortIntentFromRow(operation, submissionRow, validated.submissionId, abortRow.value);
1653
+ const joinRows = yield* sql`
1654
+ SELECT ${sql.literal(SUBMISSION_COLUMNS)}
1655
+ FROM effect_agent_submissions
1656
+ WHERE joined_host_submission_id = ${validated.submissionId}
1657
+ ORDER BY queue_sequence ASC
1658
+ `.pipe(Effect.mapError(sqlFailure(operation)));
1659
+ const joinSubmissions = yield* decodeSubmissionRows(operation, validated.submissionId, joinRows);
1660
+ const joins = yield* Effect.forEach(joinSubmissions, (row) => decodeJoinSnapshot({
1661
+ submissionId: row.submission_id,
1662
+ state: row.state,
1663
+ hostSubmissionId: validated.submissionId
1664
+ }).pipe(Effect.mapError(internalFailure(operation))));
1665
+ let hostSubmissionId;
1666
+ if (submissionRow.joined_host_submission_id !== null) hostSubmissionId = yield* decodeSubmissionId(submissionRow.joined_host_submission_id).pipe(Effect.mapError(internalFailure(operation)));
1667
+ let suspension;
1668
+ if (submissionRow.suspended_reason_json !== null && submissionRow.suspended_at !== null) {
1669
+ const reason = yield* parseStoredJsonText(submissionRow.suspended_reason_json).pipe(Effect.mapError((error) => corruptionFailure(operation, "effect_agent_submissions", validated.submissionId, error.message)));
1670
+ suspension = yield* decodeSuspensionSnapshot({
1671
+ reason,
1672
+ suspendedAt: submissionRow.suspended_at
1673
+ }).pipe(Effect.mapError((error) => corruptionFailure(operation, "effect_agent_submissions", validated.submissionId, error.message)));
1674
+ }
1675
+ const decisionRows = yield* readApprovalDecisions(operation, validated.submissionId);
1676
+ const approvalDecisions = yield* Effect.forEach(decisionRows, (row) => approvalIntentFromRow(operation, row));
1677
+ const resolutionRows = yield* readUnknownResolutions(operation, validated.submissionId);
1678
+ const unknownResolutions = yield* Effect.forEach(resolutionRows, (row) => unknownResolutionIntentFromRow(operation, row));
1679
+ const childReservationRows = yield* sql`
1680
+ SELECT ${sql.literal(CHILD_RESERVATION_COLUMNS)}
1681
+ FROM effect_agent_child_reservations
1682
+ WHERE parent_submission_id = ${validated.submissionId}
1683
+ ORDER BY parent_tool_call_id ASC
1684
+ `.pipe(Effect.mapError(sqlFailure(operation)));
1685
+ const decodedChildReservations = yield* decodeChildReservationRows(operation, validated.submissionId, childReservationRows);
1686
+ const childReservations = yield* Effect.forEach(decodedChildReservations, (row) => childReservationSnapshotFromRow(operation, row));
1687
+ const childAttachments = [];
1688
+ for (const row of decodedChildReservations) {
1689
+ if (row.child_submission_id === null) continue;
1690
+ const child = yield* readSubmission(operation, row.child_submission_id);
1691
+ if (Option.isNone(child)) continue;
1692
+ childAttachments.push(yield* decodeChildAttachmentSnapshot({
1693
+ toolCallId: row.parent_tool_call_id,
1694
+ childSubmissionId: row.child_submission_id,
1695
+ childState: child.value.state,
1696
+ ...child.value.settled_outcome === null ? {} : { childOutcome: child.value.settled_outcome }
1697
+ }).pipe(Effect.mapError(internalFailure(operation))));
1698
+ }
1699
+ let parentLinkage;
1700
+ if (submissionRow.parent_submission_id !== null && submissionRow.parent_tool_call_id !== null) parentLinkage = yield* decodeParentLinkage({
1701
+ parentSubmissionId: submissionRow.parent_submission_id,
1702
+ parentToolCallId: submissionRow.parent_tool_call_id
1703
+ }).pipe(Effect.mapError(internalFailure(operation)));
1704
+ return RecoverySnapshot.make({
1705
+ submission,
1706
+ joins,
1707
+ approvalDecisions,
1708
+ unknownResolutions,
1709
+ childReservations,
1710
+ childAttachments,
1711
+ ...parentLinkage === void 0 ? {} : { parentLinkage },
1712
+ ...hostSubmissionId === void 0 ? {} : { hostSubmissionId },
1713
+ ...suspension === void 0 ? {} : { suspension },
1714
+ ...ownership === void 0 ? {} : { ownership },
1715
+ ...inputApplied === void 0 ? {} : { inputApplied },
1716
+ ...reservation === void 0 ? {} : { reservation },
1717
+ ...abortIntent === void 0 ? {} : { abortIntent }
1718
+ });
1719
+ })).pipe(Effect.catchTag("SqliteStorageError", (error) => Effect.fail(internalFailure(operation)(error))));
1720
+ });
1721
+ return Context.make(SubmissionLedger, SubmissionLedger.of({
1722
+ capabilities,
1723
+ admit,
1724
+ markReady,
1725
+ lookup,
1726
+ resolveAdmission,
1727
+ claim,
1728
+ renewOwnership,
1729
+ releaseOwnership,
1730
+ markInputApplied,
1731
+ reserveSettlement,
1732
+ finalizeSettlement,
1733
+ requestAbort,
1734
+ claimJoining,
1735
+ markJoined,
1736
+ revertJoining,
1737
+ suspend,
1738
+ recordApprovalDecision,
1739
+ markUnknown,
1740
+ recordUnknownResolution,
1741
+ recordChildSettled,
1742
+ reserveChildBudget,
1743
+ attachChildToReservation,
1744
+ beginChildBudgetRelease,
1745
+ releaseChildBudget,
1746
+ scanNonterminal,
1747
+ loadRecoverySnapshot,
1748
+ readAbortIntent: readAbortIntentForSubmission
1749
+ }));
1750
+ });
1751
+ /**
1752
+ * SQLite SubmissionLedger implementation sharing the journal's database file, write
1753
+ * transaction discipline, and producer-epoch fencing substrate. Configuration, failpoint,
1754
+ * SQL, and Crypto authority stay visible in the input channel.
1755
+ */
1756
+ const submissionLedgerLayer = Layer.effectContext(makeServices());
1757
+ /**
1758
+ * A composition-root convenience Layer for the durable Submission Ledger. Point it at the
1759
+ * same database file as the ThreadStore so claims fence the same producer epochs.
1760
+ */
1761
+ const ledgerLayer = (options) => Layer.unwrap(Effect.map(SqliteStorageConfig, (config) => submissionLedgerLayer.pipe(Layer.provide(Layer.mergeAll(Layer.succeed(SqliteStorageConfig)(config), storageFailpointLayer(options), SqliteClient.layer({ filename: options.filename }), NodeCrypto.layer))))).pipe(Layer.provide(storageConfigLayer(options)));
1762
+ //#endregion
1763
+ export { ledgerLayer, submissionLedgerLayer, SqliteSubmissionLedger_exports as t };
1764
+
1765
+ //# sourceMappingURL=SqliteSubmissionLedger.mjs.map