@askdkc/kiokuko 0.1.28 → 0.1.30

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 (85) hide show
  1. package/dist/akinator/agent-task.d.ts.map +1 -1
  2. package/dist/akinator/agent-task.js +105 -79
  3. package/dist/akinator/agent-task.js.map +1 -1
  4. package/dist/akinator/store.d.ts.map +1 -1
  5. package/dist/akinator/store.js +5 -1
  6. package/dist/akinator/store.js.map +1 -1
  7. package/dist/commands/agent.d.ts.map +1 -1
  8. package/dist/commands/agent.js +26 -2
  9. package/dist/commands/agent.js.map +1 -1
  10. package/dist/commands/doctor.d.ts +11 -5
  11. package/dist/commands/doctor.d.ts.map +1 -1
  12. package/dist/commands/doctor.js +258 -129
  13. package/dist/commands/doctor.js.map +1 -1
  14. package/dist/commands/setup.d.ts.map +1 -1
  15. package/dist/commands/setup.js +3 -0
  16. package/dist/commands/setup.js.map +1 -1
  17. package/dist/context/delivery-migration.d.ts +40 -0
  18. package/dist/context/delivery-migration.d.ts.map +1 -0
  19. package/dist/context/delivery-migration.js +360 -0
  20. package/dist/context/delivery-migration.js.map +1 -0
  21. package/dist/context/delivery.d.ts +2 -0
  22. package/dist/context/delivery.d.ts.map +1 -1
  23. package/dist/context/delivery.js +45 -6
  24. package/dist/context/delivery.js.map +1 -1
  25. package/dist/context/nudge-store.d.ts +57 -0
  26. package/dist/context/nudge-store.d.ts.map +1 -0
  27. package/dist/context/nudge-store.js +227 -0
  28. package/dist/context/nudge-store.js.map +1 -0
  29. package/dist/context/nudge-validation.d.ts +26 -0
  30. package/dist/context/nudge-validation.d.ts.map +1 -0
  31. package/dist/context/nudge-validation.js +122 -0
  32. package/dist/context/nudge-validation.js.map +1 -0
  33. package/dist/context/nudges.d.ts +38 -0
  34. package/dist/context/nudges.d.ts.map +1 -0
  35. package/dist/context/nudges.js +131 -0
  36. package/dist/context/nudges.js.map +1 -0
  37. package/dist/context/scoped-broker.d.ts.map +1 -1
  38. package/dist/context/scoped-broker.js +5 -0
  39. package/dist/context/scoped-broker.js.map +1 -1
  40. package/dist/db/migrate.d.ts.map +1 -1
  41. package/dist/db/migrate.js +5 -0
  42. package/dist/db/migrate.js.map +1 -1
  43. package/dist/gateway/checkpoint-mutation-service.d.ts +33 -0
  44. package/dist/gateway/checkpoint-mutation-service.d.ts.map +1 -0
  45. package/dist/gateway/checkpoint-mutation-service.js +513 -0
  46. package/dist/gateway/checkpoint-mutation-service.js.map +1 -0
  47. package/dist/gateway/checkpoint-service.d.ts +22 -25
  48. package/dist/gateway/checkpoint-service.d.ts.map +1 -1
  49. package/dist/gateway/checkpoint-service.js +26 -209
  50. package/dist/gateway/checkpoint-service.js.map +1 -1
  51. package/dist/gateway/nudge-delivery-service.d.ts +21 -0
  52. package/dist/gateway/nudge-delivery-service.d.ts.map +1 -0
  53. package/dist/gateway/nudge-delivery-service.js +67 -0
  54. package/dist/gateway/nudge-delivery-service.js.map +1 -0
  55. package/dist/ledger/archive.d.ts +2 -1
  56. package/dist/ledger/archive.d.ts.map +1 -1
  57. package/dist/ledger/archive.js +109 -8
  58. package/dist/ledger/archive.js.map +1 -1
  59. package/dist/ledger/checkpoint-contract.d.ts +3 -3
  60. package/dist/ledger/maintenance.d.ts +2 -1
  61. package/dist/ledger/maintenance.d.ts.map +1 -1
  62. package/dist/ledger/maintenance.js +90 -7
  63. package/dist/ledger/maintenance.js.map +1 -1
  64. package/dist/ledger/projection.d.ts +2 -0
  65. package/dist/ledger/projection.d.ts.map +1 -1
  66. package/dist/ledger/projection.js +9 -1
  67. package/dist/ledger/projection.js.map +1 -1
  68. package/dist/memory/checkpoint-contract.d.ts +6 -6
  69. package/dist/server/agent-application.d.ts.map +1 -1
  70. package/dist/server/agent-application.js +18 -4
  71. package/dist/server/agent-application.js.map +1 -1
  72. package/dist/server/agent-checkpoint-use-case.d.ts +41 -0
  73. package/dist/server/agent-checkpoint-use-case.d.ts.map +1 -0
  74. package/dist/server/agent-checkpoint-use-case.js +158 -0
  75. package/dist/server/agent-checkpoint-use-case.js.map +1 -0
  76. package/dist/server/routes/agent-runs.d.ts +11 -4
  77. package/dist/server/routes/agent-runs.d.ts.map +1 -1
  78. package/dist/server/routes/agent-runs.js.map +1 -1
  79. package/dist/server/routes/task5.d.ts.map +1 -1
  80. package/dist/server/routes/task5.js +29 -91
  81. package/dist/server/routes/task5.js.map +1 -1
  82. package/migrations/010_nudge_deliveries.sql +50 -0
  83. package/migrations/011_nudge_integrity.sql +52 -0
  84. package/migrations/012_context_delivery_v4.sql +3 -0
  85. package/package.json +1 -1
@@ -0,0 +1,513 @@
1
+ import { randomUUID } from 'node:crypto';
2
+ import { isProxy } from 'node:util/types';
3
+ import { withImmediateTransaction } from '../db/transaction.js';
4
+ import { KiokukoError } from '../errors.js';
5
+ import { readAkinatorSession, readRunIntakeLink } from '../akinator/store.js';
6
+ import { checkpointEligibility } from '../ledger/checkpoint-eligibility.js';
7
+ import { projectLedger } from '../ledger/projection.js';
8
+ import { LedgerStore } from '../ledger/store.js';
9
+ import { sanitizeEvent } from '../ledger/redaction.js';
10
+ import { validateEventBatch, validateTimestamp } from '../ledger/validate.js';
11
+ import { COVERAGE_LEVELS } from '../ledger/types.js';
12
+ import { executeIdempotentInTransaction } from '../server/idempotency.js';
13
+ import { buildRecommendations, RECOMMENDATION_CODES, RECOMMENDATION_PRIORITY, } from '../context/recommendations.js';
14
+ import { readContextRunRetrievalState } from '../context/run-state.js';
15
+ import { recordContextFeedbackInTransaction, validateFeedbackTimestamp, } from '../context/feedback.js';
16
+ import { canonicalJson } from '../serialization/validate.js';
17
+ const CHECKPOINT_EVENT_TYPES = [
18
+ 'step.started', 'step.completed', 'step.failed', 'file.changed', 'error.recorded',
19
+ 'context.feedback', 'task_profile.revised', 'correction.recorded', 'request.received',
20
+ ];
21
+ const MAX_TEXT = 4_096;
22
+ const MAX_ARRAY = 200;
23
+ const PROFILE_FIELDS = ['taskType', 'target', 'expected', 'constraints'];
24
+ const TASK_TYPES = ['build', 'debug', 'research', 'review', 'devops', 'writing', 'analysis'];
25
+ function validation() {
26
+ throw new KiokukoError('VALIDATION_ERROR', 'Invalid checkpoint request');
27
+ }
28
+ function conflict(message = 'Checkpoint requires an active run') {
29
+ throw new KiokukoError('CONFLICT', message);
30
+ }
31
+ function checkpointIntegrity() {
32
+ throw new KiokukoError('INTEGRITY_ERROR', 'Stored checkpoint acknowledgement is invalid');
33
+ }
34
+ function assertCheckpointEligible(status) {
35
+ const eligibility = checkpointEligibility(status);
36
+ if (eligibility.allowed)
37
+ return;
38
+ throw new KiokukoError('CONFLICT', status === 'intake'
39
+ ? 'Checkpoint is not allowed during intake'
40
+ : 'Checkpoint is not allowed for a terminal run', {
41
+ checkpointEligibility: eligibility,
42
+ runStatus: status,
43
+ });
44
+ }
45
+ function assertPlainObject(value) {
46
+ if (typeof value !== 'object' || value === null || Array.isArray(value) || isProxy(value))
47
+ validation();
48
+ const prototype = Object.getPrototypeOf(value);
49
+ if (prototype !== Object.prototype && prototype !== null)
50
+ validation();
51
+ return value;
52
+ }
53
+ function isPlainRecord(value) {
54
+ if (typeof value !== 'object' || value === null || Array.isArray(value) || isProxy(value))
55
+ return false;
56
+ try {
57
+ const prototype = Object.getPrototypeOf(value);
58
+ return prototype === Object.prototype || prototype === null;
59
+ }
60
+ catch {
61
+ return false;
62
+ }
63
+ }
64
+ function isDenseArray(value) {
65
+ if (!Array.isArray(value) || isProxy(value))
66
+ return false;
67
+ try {
68
+ if (Object.getPrototypeOf(value) !== Array.prototype)
69
+ return false;
70
+ const keys = Reflect.ownKeys(value);
71
+ if (keys.length !== value.length + 1 || !keys.includes('length') || keys.some((key) => typeof key !== 'string'))
72
+ return false;
73
+ const descriptors = Object.getOwnPropertyDescriptors(value);
74
+ for (let index = 0; index < value.length; index += 1) {
75
+ const descriptor = descriptors[String(index)];
76
+ if (descriptor === undefined || !('value' in descriptor) || descriptor.enumerable !== true)
77
+ return false;
78
+ }
79
+ return true;
80
+ }
81
+ catch {
82
+ return false;
83
+ }
84
+ }
85
+ function isStringArray(value) {
86
+ if (!isDenseArray(value))
87
+ return false;
88
+ for (let index = 0; index < value.length; index += 1) {
89
+ const descriptor = Object.getOwnPropertyDescriptor(value, String(index));
90
+ if (descriptor === undefined || !('value' in descriptor) || typeof descriptor.value !== 'string')
91
+ return false;
92
+ }
93
+ return true;
94
+ }
95
+ function isNumberArray(value) {
96
+ if (!isDenseArray(value))
97
+ return false;
98
+ for (let index = 0; index < value.length; index += 1) {
99
+ const descriptor = Object.getOwnPropertyDescriptor(value, String(index));
100
+ if (descriptor === undefined || !('value' in descriptor)
101
+ || typeof descriptor.value !== 'number'
102
+ || !Number.isSafeInteger(descriptor.value)
103
+ || descriptor.value < 0)
104
+ return false;
105
+ }
106
+ return true;
107
+ }
108
+ function isSourceSequenceArray(value) {
109
+ if (!isDenseArray(value))
110
+ return false;
111
+ for (let index = 0; index < value.length; index += 1) {
112
+ const descriptor = Object.getOwnPropertyDescriptor(value, String(index));
113
+ if (descriptor === undefined || !('value' in descriptor)
114
+ || (descriptor.value !== null && (typeof descriptor.value !== 'number'
115
+ || !Number.isSafeInteger(descriptor.value) || descriptor.value < 0)))
116
+ return false;
117
+ }
118
+ return true;
119
+ }
120
+ function isNonNegativeSequence(value) {
121
+ return typeof value === 'number' && Number.isSafeInteger(value) && value >= 0;
122
+ }
123
+ function isNullableString(value) {
124
+ return value === null || typeof value === 'string';
125
+ }
126
+ function isTaskProfile(value) {
127
+ if (!isPlainRecord(value))
128
+ return false;
129
+ return (value.taskType === null || (typeof value.taskType === 'string'
130
+ && TASK_TYPES.includes(value.taskType)))
131
+ && isNullableString(value.target)
132
+ && isNullableString(value.expected)
133
+ && isNullableString(value.constraints);
134
+ }
135
+ function isResponseTaskProfile(value) {
136
+ return isTaskProfile(value) && isPlainRecord(value) && value.source === 'akinator+ledger-revisions';
137
+ }
138
+ function isCoverage(value) {
139
+ if (!isPlainRecord(value))
140
+ return false;
141
+ return ['run', 'tool', 'command', 'file', 'approval'].every((field) => (typeof value[field] === 'string' && COVERAGE_LEVELS.includes(value[field])));
142
+ }
143
+ function isProjection(value) {
144
+ if (!isPlainRecord(value))
145
+ return false;
146
+ const evidenceStates = ['none', 'failed', 'fresh', 'stale'];
147
+ const missingFields = ['taskType', 'target', 'expected'];
148
+ return isNonNegativeSequence(value.throughSequence)
149
+ && isTaskProfile(value.taskProfile)
150
+ && typeof value.profileHash === 'string'
151
+ && typeof value.evidenceState === 'string'
152
+ && evidenceStates.includes(value.evidenceState)
153
+ && isStringArray(value.unresolvedFailureEventIds)
154
+ && isStringArray(value.unknownOutcomeEventIds)
155
+ && (value.latestMutationSequence === null || isNonNegativeSequence(value.latestMutationSequence))
156
+ && isStringArray(value.latestMutationEventIds)
157
+ && (value.latestPassingVerificationSequence === null || isNonNegativeSequence(value.latestPassingVerificationSequence))
158
+ && isStringArray(value.latestPassingVerificationEventIds)
159
+ && (value.coverage === 'complete' || value.coverage === 'partial')
160
+ && isCoverage(value.declaredCoverage)
161
+ && typeof value.intakeIncomplete === 'boolean'
162
+ && isDenseArray(value.missingProfileFields)
163
+ && value.missingProfileFields.every((field) => typeof field === 'string'
164
+ && missingFields.includes(field));
165
+ }
166
+ function isRecommendation(value) {
167
+ if (!isPlainRecord(value) || typeof value.code !== 'string'
168
+ || !RECOMMENDATION_CODES.includes(value.code)
169
+ || typeof value.message !== 'string'
170
+ || !isStringArray(value.evidenceEventIds)
171
+ || typeof value.priority !== 'number'
172
+ || value.priority !== RECOMMENDATION_PRIORITY[value.code]
173
+ || value.untrusted !== true
174
+ || value.actionable !== false
175
+ || !isPlainRecord(value.metadata)
176
+ || typeof value.metadata.truncated !== 'boolean'
177
+ || !isStringArray(value.metadata.referenceIds))
178
+ return false;
179
+ return value.metadata.incompleteCoverageCategories === undefined
180
+ || isStringArray(value.metadata.incompleteCoverageCategories);
181
+ }
182
+ function isRecommendationArray(value) {
183
+ if (!isDenseArray(value))
184
+ return false;
185
+ for (let index = 0; index < value.length; index += 1) {
186
+ const descriptor = Object.getOwnPropertyDescriptor(value, String(index));
187
+ if (descriptor === undefined || !('value' in descriptor) || !isRecommendation(descriptor.value))
188
+ return false;
189
+ }
190
+ return true;
191
+ }
192
+ function isCheckpointMutationResult(value) {
193
+ if (!isPlainRecord(value))
194
+ return false;
195
+ return typeof value.runId === 'string'
196
+ && isNonNegativeSequence(value.acceptedThrough)
197
+ && isNumberArray(value.localSequences)
198
+ && isSourceSequenceArray(value.sourceSequences)
199
+ && isStringArray(value.eventIds)
200
+ && value.runStatus === 'active'
201
+ && (value.intakeStatus === 'ready' || value.intakeStatus === 'exhausted')
202
+ && isResponseTaskProfile(value.taskProfile)
203
+ && typeof value.profileHash === 'string'
204
+ && isProjection(value.projection)
205
+ && isRecommendationArray(value.preliminaryRecommendations)
206
+ && typeof value.characterBudget === 'number'
207
+ && Number.isSafeInteger(value.characterBudget)
208
+ && value.characterBudget >= 1
209
+ && value.characterBudget <= 100_000;
210
+ }
211
+ function storedCheckpointObject(value) {
212
+ if (!isPlainRecord(value)) {
213
+ throw new KiokukoError('INTEGRITY_ERROR', 'Stored checkpoint acknowledgement is invalid');
214
+ }
215
+ return value;
216
+ }
217
+ function serializeCheckpointAcknowledgement(value) {
218
+ const { preliminaryRecommendations, ...acknowledgement } = value;
219
+ return {
220
+ ...acknowledgement,
221
+ recommendations: preliminaryRecommendations,
222
+ nudge: null,
223
+ context: null,
224
+ untrusted: true,
225
+ };
226
+ }
227
+ function sameTaskProfile(left, right) {
228
+ return left.taskType === right.taskType
229
+ && left.target === right.target
230
+ && left.expected === right.expected
231
+ && left.constraints === right.constraints;
232
+ }
233
+ function assertCheckpointAcknowledgementAgainstLedger(database, acknowledgement) {
234
+ if (acknowledgement.localSequences.length > MAX_ARRAY)
235
+ checkpointIntegrity();
236
+ const placeholders = acknowledgement.localSequences.map(() => '?').join(', ');
237
+ const rows = database.prepare(`
238
+ SELECT sequence, source_sequence, event_id
239
+ FROM ledger_events
240
+ WHERE run_id = ?
241
+ AND sequence IN (${placeholders})
242
+ ORDER BY sequence ASC
243
+ `).all(acknowledgement.runId, ...acknowledgement.localSequences);
244
+ if (rows.length !== acknowledgement.localSequences.length)
245
+ checkpointIntegrity();
246
+ for (let index = 0; index < rows.length; index += 1) {
247
+ const row = rows[index];
248
+ if (row === undefined
249
+ || row.sequence !== acknowledgement.localSequences[index]
250
+ || row.source_sequence !== acknowledgement.sourceSequences[index]
251
+ || row.event_id !== acknowledgement.eventIds[index]) {
252
+ checkpointIntegrity();
253
+ }
254
+ }
255
+ }
256
+ function assertCheckpointMutationInvariants(normalized, expected, database) {
257
+ if (normalized.runId !== expected.runId
258
+ || normalized.characterBudget !== expected.characterBudget
259
+ || normalized.acceptedThrough !== normalized.projection.throughSequence
260
+ || normalized.profileHash !== normalized.projection.profileHash
261
+ || !sameTaskProfile(normalized.taskProfile, normalized.projection.taskProfile)
262
+ || normalized.localSequences.length === 0
263
+ || normalized.localSequences.length !== normalized.sourceSequences.length
264
+ || normalized.localSequences.length !== normalized.eventIds.length
265
+ || normalized.localSequences.at(-1) !== normalized.acceptedThrough) {
266
+ throw new KiokukoError('INTEGRITY_ERROR', 'Stored checkpoint acknowledgement is invalid');
267
+ }
268
+ assertCheckpointAcknowledgementAgainstLedger(database, normalized);
269
+ let authoritative;
270
+ try {
271
+ authoritative = projectionFor(database, normalized.runId, normalized.acceptedThrough);
272
+ }
273
+ catch (error) {
274
+ if (error instanceof KiokukoError)
275
+ checkpointIntegrity();
276
+ throw error;
277
+ }
278
+ if (authoritative.intakeStatus !== normalized.intakeStatus
279
+ || canonicalJson(authoritative.projection) !== canonicalJson(normalized.projection)
280
+ || normalized.profileHash !== authoritative.projection.profileHash
281
+ || !sameTaskProfile(normalized.taskProfile, authoritative.projection.taskProfile)) {
282
+ checkpointIntegrity();
283
+ }
284
+ let recommendations;
285
+ try {
286
+ recommendations = buildRecommendations({ projection: authoritative.projection, broker: {} });
287
+ }
288
+ catch {
289
+ throw new KiokukoError('INTEGRITY_ERROR', 'Stored checkpoint acknowledgement is invalid');
290
+ }
291
+ if (canonicalJson(normalized.preliminaryRecommendations) !== canonicalJson(recommendations)) {
292
+ throw new KiokukoError('INTEGRITY_ERROR', 'Stored checkpoint acknowledgement is invalid');
293
+ }
294
+ }
295
+ function normalizeCheckpointMutationResult(database, value, expected) {
296
+ const object = storedCheckpointObject(value);
297
+ const recommendations = Object.hasOwn(object, 'preliminaryRecommendations')
298
+ ? object.preliminaryRecommendations
299
+ : object.recommendations;
300
+ const normalized = { ...object, preliminaryRecommendations: recommendations };
301
+ if (!isCheckpointMutationResult(normalized)) {
302
+ throw new KiokukoError('INTEGRITY_ERROR', 'Stored checkpoint acknowledgement is invalid');
303
+ }
304
+ const result = {
305
+ runId: normalized.runId,
306
+ acceptedThrough: normalized.acceptedThrough,
307
+ localSequences: normalized.localSequences,
308
+ sourceSequences: normalized.sourceSequences,
309
+ eventIds: normalized.eventIds,
310
+ runStatus: normalized.runStatus,
311
+ intakeStatus: normalized.intakeStatus,
312
+ taskProfile: normalized.taskProfile,
313
+ profileHash: normalized.profileHash,
314
+ projection: normalized.projection,
315
+ preliminaryRecommendations: normalized.preliminaryRecommendations,
316
+ characterBudget: normalized.characterBudget,
317
+ };
318
+ assertCheckpointMutationInvariants(result, expected, database);
319
+ return result;
320
+ }
321
+ function boundedString(value, max = MAX_TEXT) {
322
+ if (typeof value !== 'string' || value.length === 0 || value.length > max || /\p{Cc}/u.test(value))
323
+ validation();
324
+ return value;
325
+ }
326
+ function stringArray(value) {
327
+ if (!Array.isArray(value) || value.length > MAX_ARRAY)
328
+ validation();
329
+ return value.map((item) => boundedString(item));
330
+ }
331
+ function jsonValue(value) {
332
+ if (value === null || typeof value === 'boolean' || typeof value === 'string')
333
+ return value;
334
+ if (typeof value === 'number' && Number.isFinite(value))
335
+ return value;
336
+ if (Array.isArray(value))
337
+ return value.map(jsonValue);
338
+ const object = assertPlainObject(value);
339
+ const result = {};
340
+ for (const key of Object.keys(object))
341
+ result[key] = jsonValue(object[key]);
342
+ return result;
343
+ }
344
+ function partialProfile(value) {
345
+ const object = assertPlainObject(value);
346
+ if (Object.keys(object).some((field) => !PROFILE_FIELDS.includes(field)))
347
+ validation();
348
+ const result = {};
349
+ for (const field of PROFILE_FIELDS) {
350
+ if (!Object.hasOwn(object, field))
351
+ continue;
352
+ const fieldValue = object[field];
353
+ if (field === 'taskType') {
354
+ if (fieldValue !== null && (typeof fieldValue !== 'string' || !TASK_TYPES.includes(fieldValue)))
355
+ validation();
356
+ }
357
+ else if (fieldValue !== null && typeof fieldValue !== 'string') {
358
+ validation();
359
+ }
360
+ result[field] = jsonValue(fieldValue);
361
+ }
362
+ if (Object.keys(result).length === 0)
363
+ validation();
364
+ return result;
365
+ }
366
+ function event(eventType, payload, now) {
367
+ return { eventId: randomUUID(), eventType, actor: 'kiokuko-checkpoint', occurredAt: now, payload };
368
+ }
369
+ function normalizeRequest(raw, workspace, now) {
370
+ const value = assertPlainObject(raw);
371
+ const allowed = new Set([
372
+ 'apiVersion', 'events', 'currentGoal', 'currentStep', 'changedPaths', 'errorSignatures',
373
+ 'unresolvedItems', 'contextFeedback', 'taskProfileRevision', 'characterBudget',
374
+ ]);
375
+ if (Object.keys(value).some((key) => !allowed.has(key)) || value.apiVersion !== '1')
376
+ validation();
377
+ const events = [];
378
+ if (value.events !== undefined) {
379
+ if (!Array.isArray(value.events) || value.events.length === 0)
380
+ validation();
381
+ const validated = validateEventBatch({ events: value.events });
382
+ for (const item of validated) {
383
+ if (!CHECKPOINT_EVENT_TYPES.includes(item.eventType))
384
+ validation();
385
+ events.push(sanitizeEvent(item, { workspace }).value);
386
+ }
387
+ }
388
+ if (value.currentGoal !== undefined)
389
+ events.push(event('step.started', { goal: boundedString(value.currentGoal) }, now));
390
+ if (value.currentStep !== undefined)
391
+ events.push(event('step.started', { step: boundedString(value.currentStep) }, now));
392
+ if (value.changedPaths !== undefined) {
393
+ for (const path of stringArray(value.changedPaths))
394
+ events.push(event('file.changed', { path }, now));
395
+ }
396
+ if (value.errorSignatures !== undefined) {
397
+ for (const signature of stringArray(value.errorSignatures))
398
+ events.push(event('error.recorded', { signature }, now));
399
+ }
400
+ if (value.unresolvedItems !== undefined) {
401
+ for (const item of stringArray(value.unresolvedItems))
402
+ events.push(event('correction.recorded', { unresolved: item }, now));
403
+ }
404
+ if (value.taskProfileRevision !== undefined)
405
+ events.push(event('task_profile.revised', { profile: partialProfile(value.taskProfileRevision) }, now));
406
+ const contextFeedback = value.contextFeedback === undefined ? [] : (() => {
407
+ if (!Array.isArray(value.contextFeedback) || value.contextFeedback.length > MAX_ARRAY)
408
+ validation();
409
+ return value.contextFeedback.map((item) => {
410
+ const feedback = assertPlainObject(item);
411
+ if (feedback.comment !== undefined && feedback.comment !== null)
412
+ boundedString(feedback.comment);
413
+ return item;
414
+ });
415
+ })();
416
+ for (const feedback of contextFeedback)
417
+ events.push(event('context.feedback', jsonValue(feedback), now));
418
+ if (events.length === 0 || events.length > 200)
419
+ validation();
420
+ const characterBudget = value.characterBudget === undefined ? 8_000 : value.characterBudget;
421
+ if (typeof characterBudget !== 'number' || !Number.isSafeInteger(characterBudget) || characterBudget < 1 || characterBudget > 100_000)
422
+ validation();
423
+ return { events, contextFeedback, characterBudget };
424
+ }
425
+ function projectionFor(database, runId, acceptedThrough) {
426
+ const state = readContextRunRetrievalState(database, runId);
427
+ if (acceptedThrough > state.run.lastSequence) {
428
+ checkpointIntegrity();
429
+ }
430
+ const store = new LedgerStore(database);
431
+ const run = state.run;
432
+ const link = readRunIntakeLink(database, { workspace: run.workspace, runId });
433
+ const session = readAkinatorSession(database, { workspace: run.workspace, sessionId: link.sessionId });
434
+ if (session.status !== 'ready' && session.status !== 'exhausted')
435
+ conflict('Checkpoint requires finalized intake');
436
+ const events = store.readEvents(runId).filter((row) => row.sequence <= acceptedThrough).map((row) => ({
437
+ eventId: row.event_id,
438
+ sequence: row.sequence,
439
+ eventType: row.event_type,
440
+ ...(row.outcome === null ? {} : { outcome: row.outcome }),
441
+ ...(row.payload_json === null ? {} : { payload: JSON.parse(row.payload_json) }),
442
+ }));
443
+ return {
444
+ intakeStatus: session.status,
445
+ projection: projectLedger({
446
+ initialProfile: session.profile,
447
+ intakeStatus: session.status,
448
+ coverage: run.coverage,
449
+ throughSequence: acceptedThrough,
450
+ events,
451
+ }),
452
+ };
453
+ }
454
+ function mutationValue(database, runId, request, idempotencyKey, now) {
455
+ // Validate the authoritative state before the first mutation.
456
+ const currentRun = new LedgerStore(database).readRun(runId);
457
+ if (!currentRun)
458
+ throw new KiokukoError('NOT_FOUND', 'Ledger run not found');
459
+ assertCheckpointEligible(currentRun.status);
460
+ const state = readContextRunRetrievalState(database, runId);
461
+ const run = state.run;
462
+ const store = new LedgerStore(database);
463
+ const ack = store.appendBatchInTransaction(runId, { events: request.events });
464
+ for (let index = 0; index < request.contextFeedback.length; index += 1) {
465
+ const feedback = assertPlainObject(request.contextFeedback[index]);
466
+ recordContextFeedbackInTransaction(database, {
467
+ ...feedback,
468
+ workspace: run.workspace,
469
+ runId,
470
+ actor: Object.hasOwn(feedback, 'actor') ? feedback.actor : 'kiokuko-checkpoint',
471
+ idempotencyKey: `${idempotencyKey}:context:${index}`,
472
+ createdAt: Object.hasOwn(feedback, 'createdAt') ? validateFeedbackTimestamp(feedback.createdAt) : now,
473
+ });
474
+ }
475
+ const { intakeStatus, projection } = projectionFor(database, runId, ack.acceptedThrough);
476
+ const preliminaryRecommendations = buildRecommendations({ projection, broker: {} });
477
+ return {
478
+ ...ack,
479
+ runStatus: 'active',
480
+ intakeStatus,
481
+ taskProfile: { ...projection.taskProfile, source: 'akinator+ledger-revisions' },
482
+ profileHash: projection.profileHash,
483
+ projection,
484
+ preliminaryRecommendations,
485
+ characterBudget: request.characterBudget,
486
+ };
487
+ }
488
+ export class CheckpointMutationService {
489
+ database;
490
+ now;
491
+ constructor(database, now = () => new Date().toISOString()) {
492
+ this.database = database;
493
+ this.now = now;
494
+ }
495
+ checkpoint(input) {
496
+ const value = assertPlainObject(input);
497
+ if (typeof value.runId !== 'string' || value.runId.length === 0 || typeof value.idempotencyKey !== 'string' || value.idempotencyKey.length === 0)
498
+ validation();
499
+ const run = new LedgerStore(this.database).readRun(value.runId);
500
+ if (!run)
501
+ throw new KiokukoError('NOT_FOUND', 'Ledger run not found');
502
+ const now = validateTimestamp(this.now(), 'createdAt');
503
+ const request = normalizeRequest(value.request, run.workspace, now);
504
+ return withImmediateTransaction(this.database, () => {
505
+ const response = executeIdempotentInTransaction(this.database, { scope: `agent.checkpoint.${value.runId}`, key: value.idempotencyKey, request: value.request, createdAt: now }, () => serializeCheckpointAcknowledgement(mutationValue(this.database, value.runId, request, value.idempotencyKey, now)));
506
+ return normalizeCheckpointMutationResult(this.database, response, {
507
+ runId: value.runId,
508
+ characterBudget: request.characterBudget,
509
+ });
510
+ });
511
+ }
512
+ }
513
+ //# sourceMappingURL=checkpoint-mutation-service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"checkpoint-mutation-service.js","sourceRoot":"","sources":["../../src/gateway/checkpoint-mutation-service.ts"],"names":[],"mappings":"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"}
@@ -1,33 +1,30 @@
1
1
  import type { SqliteDatabase } from '../db/adapter.js';
2
- import { type LedgerProjection } from '../ledger/projection.js';
3
- import { type Recommendation } from '../context/recommendations.js';
4
- export interface CheckpointResponse {
5
- runId: string;
6
- acceptedThrough: number;
7
- localSequences: number[];
8
- sourceSequences: Array<number | null>;
9
- eventIds: string[];
10
- runStatus: 'active';
11
- intakeStatus: 'ready' | 'exhausted';
12
- taskProfile: {
13
- taskType: string | null;
14
- target: string | null;
15
- expected: string | null;
16
- constraints: string | null;
17
- source: 'akinator+ledger-revisions';
18
- };
19
- profileHash: string;
20
- projection: LedgerProjection;
21
- recommendations: Recommendation[];
22
- characterBudget: number;
23
- context: null;
24
- untrusted: true;
2
+ import type { Recommendation } from '../context/recommendations.js';
3
+ import type { DeliveredNudge } from '../context/nudges.js';
4
+ import { type CheckpointMutationResult } from './checkpoint-mutation-service.js';
5
+ import { type ValidatedNudgeDeliveryRequest } from './nudge-delivery-service.js';
6
+ export { CheckpointMutationService } from './checkpoint-mutation-service.js';
7
+ export type { CheckpointMutationResult } from './checkpoint-mutation-service.js';
8
+ export { NudgeDeliveryService } from './nudge-delivery-service.js';
9
+ export type { ValidatedNudgeDeliveryRequest } from './nudge-delivery-service.js';
10
+ export interface CheckpointResponse extends Omit<CheckpointMutationResult, 'preliminaryRecommendations'> {
11
+ readonly recommendations: readonly Recommendation[];
12
+ readonly nudge: DeliveredNudge | null;
13
+ readonly context: null;
14
+ readonly untrusted: true;
15
+ }
16
+ export interface LegacyCheckpointServicePort {
17
+ checkpoint(input: unknown): CheckpointResponse;
18
+ deliverNudge(input: ValidatedNudgeDeliveryRequest): DeliveredNudge | null;
25
19
  }
26
20
  export declare class CheckpointService {
27
- private readonly database;
28
- private readonly now;
21
+ private readonly mutation;
22
+ private readonly nudgeDelivery;
29
23
  constructor(database: SqliteDatabase, now?: () => string);
24
+ /** @deprecated Use CheckpointMutationService and NudgeDeliveryService directly. */
30
25
  checkpoint(input: unknown): CheckpointResponse;
26
+ /** @deprecated Use NudgeDeliveryService directly. */
27
+ deliverNudge(input: ValidatedNudgeDeliveryRequest): DeliveredNudge | null;
31
28
  }
32
29
  export interface FeedbackResponse {
33
30
  category: 'context' | 'recommendation' | 'intake' | 'run';
@@ -1 +1 @@
1
- {"version":3,"file":"checkpoint-service.d.ts","sourceRoot":"","sources":["../../src/gateway/checkpoint-service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAKvD,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAM/E,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAwB1F,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACtC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,QAAQ,CAAC;IACpB,YAAY,EAAE,OAAO,GAAG,WAAW,CAAC;IACpC,WAAW,EAAE;QACX,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,MAAM,EAAE,2BAA2B,CAAC;KACrC,CAAC;IACF,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,IAAI,CAAC;IACd,SAAS,EAAE,IAAI,CAAC;CACjB;AAqLD,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAAkB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAA9C,QAAQ,EAAE,cAAc,EAAmB,GAAG,GAAE,MAAM,MAAuC;IAE1H,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB;CAa/C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,SAAS,GAAG,gBAAgB,GAAG,QAAQ,GAAG,KAAK,CAAC;IAC1D,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAyED,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAAkB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAA9C,QAAQ,EAAE,cAAc,EAAmB,GAAG,GAAE,MAAM,MAAuC;IAE1H,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB;CAa3C"}
1
+ {"version":3,"file":"checkpoint-service.d.ts","sourceRoot":"","sources":["../../src/gateway/checkpoint-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAQvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAO3D,OAAO,EAA6B,KAAK,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5G,OAAO,EAAwB,KAAK,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AAEvG,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,YAAY,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,YAAY,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AAEjF,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,wBAAwB,EAAE,4BAA4B,CAAC;IACtG,QAAQ,CAAC,eAAe,EAAE,SAAS,cAAc,EAAE,CAAC;IACpD,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,2BAA2B;IAC1C,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAAC;IAC/C,YAAY,CAAC,KAAK,EAAE,6BAA6B,GAAG,cAAc,GAAG,IAAI,CAAC;CAC3E;AAkBD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuB;gBAEzC,QAAQ,EAAE,cAAc,EAAE,GAAG,GAAE,MAAM,MAAuC;IAKxF,mFAAmF;IACnF,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB;IAY9C,qDAAqD;IACrD,YAAY,CAAC,KAAK,EAAE,6BAA6B,GAAG,cAAc,GAAG,IAAI;CAG1E;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,SAAS,GAAG,gBAAgB,GAAG,QAAQ,GAAG,KAAK,CAAC;IAC1D,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAyED,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAAkB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAA9C,QAAQ,EAAE,cAAc,EAAmB,GAAG,GAAE,MAAM,MAAuC;IAE1H,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB;CAa3C"}