@namzu/sdk 30.2.0 → 31.0.0

package/dist/store/attachment/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/store/attachment/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAE9E;;;;;;;;;;;;;;;;GAgBG;AAEH,qDAAqD;AACrD,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;IACvB;;;;;;OAMG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,CAAA;IACnC,kEAAkE;IAClE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,sEAAsE;IACtE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,eAAe;IAC/B;;;;;OAKG;IACH,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACxC,sDAAsD;IACtD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAA;CAClD;AAED,yCAAyC;AACzC,qBAAa,uBAAwB,SAAQ,KAAK;IACjD,QAAQ,CAAC,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;gBAErB,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE;CAKpC;AAED,yEAAyE;AACzE,qBAAa,sBAAuB,SAAQ,KAAK;IAChD,QAAQ,CAAC,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;gBAErB,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE;CAOpC;AAED,mEAAmE;AACnE,qBAAa,gCAAiC,SAAQ,KAAK;IAC1D,QAAQ,CAAC,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;gBAEvD,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAOtE;AAED,eAAO,MAAM,kBAAkB,GAC9B,YAAY,iBAAiB,KAC3B,UAAU,IAAI,iBAAiB,GAAG,gBACe,CAAA;AAEpD;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACtC,UAAU,EAAE,iBAAiB,EAC7B,KAAK,EAAE,eAAe,GAAG,SAAS,GAChC,OAAO,CAAC,iBAAiB,CAAC,CA8B5B;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACvC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,KAAK,EAAE,eAAe,GAAG,SAAS,GAChC,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAoB7B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/store/attachment/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAE9E;;;;;;;;;;;;;;;;GAgBG;AAEH,qDAAqD;AACrD,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;IACvB;;;;;;OAMG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,CAAA;IACnC,kEAAkE;IAClE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,sEAAsE;IACtE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC1B;AAED,sEAAsE;AACtE,MAAM,WAAW,0BAA0B;IAC1C;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC7B;AAED,MAAM,WAAW,eAAe;IAC/B;;;;;OAKG;IACH,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACxC,sDAAsD;IACtD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,0BAA0B,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAA;CACxF;AAED,yCAAyC;AACzC,qBAAa,uBAAwB,SAAQ,KAAK;IACjD,QAAQ,CAAC,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;gBAErB,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE;CAKpC;AAED,yEAAyE;AACzE,qBAAa,sBAAuB,SAAQ,KAAK;IAChD,QAAQ,CAAC,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;gBAErB,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE;CAOpC;AAED,mEAAmE;AACnE,qBAAa,gCAAiC,SAAQ,KAAK;IAC1D,QAAQ,CAAC,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;gBAEvD,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAOtE;AAED,eAAO,MAAM,kBAAkB,GAC9B,YAAY,iBAAiB,KAC3B,UAAU,IAAI,iBAAiB,GAAG,gBACe,CAAA;AAEpD;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACtC,UAAU,EAAE,iBAAiB,EAC7B,KAAK,EAAE,eAAe,GAAG,SAAS,EAClC,OAAO,GAAE,0BAA+B,GACtC,OAAO,CAAC,iBAAiB,CAAC,CAsC5B;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACvC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,KAAK,EAAE,eAAe,GAAG,SAAS,EAClC,OAAO,GAAE,0BAA+B,GACtC,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAuB7B"}

package/dist/store/attachment/index.js

@@ -35,12 +35,18 @@ export const isStoredAttachment = (attachment) => attachment.type === 'stored';
  * why — the worst available outcome, and the reason none of these three
  * branches returns the message unchanged.
  */
-export async function resolveAttachment(attachment, store) {
+export async function resolveAttachment(attachment, store, options = {}) {
+    const { signal } = options;
+    signal?.throwIfAborted();
     if (!isStoredAttachment(attachment))
         return attachment;
     if (!store)
         throw new NoAttachmentStoreError({ ref: attachment.ref });
-    const bytes = await store.get(attachment.ref);
+    const bytes = await awaitStoreRead(signal, () => signal ? store.get(attachment.ref, { signal }) : store.get(attachment.ref));
+    // A store completion can win its promise reaction and remove the abort
+    // listener immediately before an already-queued abort. Publication is a
+    // second authority boundary, so fence it independently.
+    signal?.throwIfAborted();
     if (!bytes)
         throw new AttachmentNotFoundError({ ref: attachment.ref });
     if (bytes.mediaType !== attachment.mediaType) {
@@ -73,7 +79,8 @@ export async function resolveAttachment(attachment, store) {
  * one scan and no allocation — and so a caller cannot tell resolved
  * messages from unresolved ones by identity and get it wrong.
  */
-export async function resolveAttachments(messages, store) {
+export async function resolveAttachments(messages, store, options = {}) {
+    options.signal?.throwIfAborted();
     // `Message` rather than a structural constraint: only some members of
     // the union carry `attachments`, and a structural bound over a union
     // like that is not assignable in either direction. Naming the real type
@@ -87,8 +94,46 @@ export async function resolveAttachments(messages, store) {
             return message;
         return {
             ...message,
-            attachments: await Promise.all(attachments.map((a) => resolveAttachment(a, store))),
+            attachments: await Promise.all(attachments.map((attachment) => resolveAttachment(attachment, store, options))),
         };
     }));
 }
+/**
+ * Await a host store without handing it ownership of run cancellation.
+ *
+ * Forwarding the signal is cooperative cleanup; this race is the public
+ * liveness boundary when a remote or custom store ignores it. The first cause
+ * wins, and late store completion has no route back into the returned value.
+ */
+async function awaitStoreRead(signal, start) {
+    if (!signal)
+        return await start();
+    signal.throwIfAborted();
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const cleanup = () => signal.removeEventListener('abort', onAbort);
+        const rejectOnce = (reason) => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            reject(reason);
+        };
+        const resolveOnce = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            resolve(value);
+        };
+        const onAbort = () => rejectOnce(signal.reason);
+        signal.addEventListener('abort', onAbort, { once: true });
+        try {
+            Promise.resolve(start()).then(resolveOnce, rejectOnce);
+        }
+        catch (error) {
+            rejectOnce(error);
+        }
+    });
+}
 //# sourceMappingURL=index.js.map

package/dist/store/attachment/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/store/attachment/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/store/attachment/index.ts"],"names":[],"mappings":"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"}

package/dist/store/feedback/conformance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conformance.d.ts","sourceRoot":"","sources":["../../../src/store/feedback/conformance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AAChE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEtD;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,0BAA0B;IAC1C,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK,IAAI,CAAA;IAC3D,QAAQ,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,KAAK,IAAI,CAAA;IACrE,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK;QACrC,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAA;QAC7B,OAAO,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAA;QAChC,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAC7B,CAAA;IACD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,iEAAiE;IACjE,QAAQ,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC;QACjC,KAAK,EAAE,oBAAoB,CAAA;QAC3B,KAAK,EAAE,KAAK,CAAA;QACZ,cAAc,EAAE,SAAS,CAAA;QACzB,yDAAyD;QACzD,gBAAgB,EAAE,SAAS,CAAA;QAC3B,UAAU,EAAE,KAAK,CAAA;QACjB,mBAAmB,EAAE,SAAS,CAAA;KAC9B,CAAC,CAAA;CACF;AAED,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAmJ1F"}
+{"version":3,"file":"conformance.d.ts","sourceRoot":"","sources":["../../../src/store/feedback/conformance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AAChE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEtD;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,0BAA0B;IAC1C,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK,IAAI,CAAA;IAC3D,QAAQ,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,KAAK,IAAI,CAAA;IACrE,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK;QACrC,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAA;QAC7B,OAAO,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAA;QAChC,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAC7B,CAAA;IACD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,iEAAiE;IACjE,QAAQ,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC;QACjC,KAAK,EAAE,oBAAoB,CAAA;QAC3B,KAAK,EAAE,KAAK,CAAA;QACZ,cAAc,EAAE,SAAS,CAAA;QACzB,yDAAyD;QACzD,gBAAgB,EAAE,SAAS,CAAA;QAC3B,UAAU,EAAE,KAAK,CAAA;QACjB,mBAAmB,EAAE,SAAS,CAAA;KAC9B,CAAC,CAAA;CACF;AAED,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI,CA0L1F"}

package/dist/store/feedback/conformance.js

@@ -64,6 +64,38 @@ export function defineMessageFeedbackConformance(options) {
             expect(listed).toHaveLength(1);
             expect(listed[0]?.ownerVersion).toBe(1);
         });
+        it('lets exactly one of two racing updates advance a stored version', async () => {
+            const { store, runId, knownMessageId } = await makeStore();
+            await store.putMessageFeedback({
+                runId,
+                messageId: knownMessageId,
+                rating: 'good',
+                expectedVersion: 0,
+            });
+            const attempts = [
+                { rating: 'good', note: 'writer-a' },
+                { rating: 'bad', note: 'writer-b' },
+            ].map((candidate) => store
+                .putMessageFeedback({
+                runId,
+                messageId: knownMessageId,
+                ...candidate,
+                expectedVersion: 1,
+            })
+                .then((record) => ({ kind: 'ok', record }), () => ({ kind: 'refused' })));
+            const outcomes = await Promise.all(attempts);
+            const winners = outcomes.filter((outcome) => outcome.kind === 'ok');
+            expect(winners).toHaveLength(1);
+            expect(outcomes.filter((outcome) => outcome.kind === 'refused')).toHaveLength(1);
+            const winner = winners[0];
+            if (winner?.kind !== 'ok')
+                throw new Error('expected one feedback update winner');
+            const listed = await store.listMessageFeedback({ runId });
+            expect(listed).toHaveLength(1);
+            expect(listed[0]?.ownerVersion).toBe(2);
+            expect(listed[0]?.rating).toBe(winner.record.rating);
+            expect(listed[0]?.note).toBe(winner.record.note);
+        });
         it('advances the version on a correct update', async () => {
             const { store, runId, knownMessageId } = await makeStore();
             await store.putMessageFeedback({

package/dist/store/feedback/conformance.js.map

@@ -1 +1 @@
-{"version":3,"file":"conformance.js","sourceRoot":"","sources":["../../../src/store/feedback/conformance.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"conformance.js","sourceRoot":"","sources":["../../../src/store/feedback/conformance.ts"],"names":[],"mappings":"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"}

package/dist/store/feedback/disk.d.ts

@@ -2,13 +2,12 @@ import type { RunId } from '../../types/ids/index.js';
 import type { MessageExistenceCheck } from './memory.js';
 import { type MessageFeedback, type MessageFeedbackStore, type PutMessageFeedbackInput } from './types.js';
 /**
- * Feedback on disk, one file per rated message.
+ * Feedback on disk, one immutable commit per accepted owner version.
  *
- * One file rather than one appended log per run, because a rating is a
- * RECORD — it is replaced, not accumulated — and compare-and-set on a
- * record is what stops two raters silently overwriting each other. An
- * append log would have to be replayed to answer "what is the rating now",
- * and two appends racing would both succeed.
+ * A rating is a RECORD — readers want its current value — but replacing one
+ * mutable file cannot make the preceding version comparison atomic. The
+ * revision directory elects exactly one writer for N+1; the former single
+ * file remains only a checked, best-effort compatibility projection.
  */
 export interface DiskMessageFeedbackStoreConfig {
     /** Where feedback lives. Sibling of the run tree, not inside it. */
@@ -38,6 +37,9 @@ export declare class DiskMessageFeedbackStore implements MessageFeedbackStore {
     private readonly messageExists;
     constructor(config: DiskMessageFeedbackStoreConfig, messageExists?: MessageExistenceCheck, now?: () => number);
     private runDir;
+    private revisionsDir;
+    private location;
+    private assertKey;
     putMessageFeedback(input: PutMessageFeedbackInput): Promise<MessageFeedback>;
     listMessageFeedback(query: {
         runId: RunId;

package/dist/store/feedback/disk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"disk.d.ts","sourceRoot":"","sources":["../../../src/store/feedback/disk.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAa,KAAK,EAAE,MAAM,0BAA0B,CAAA;AAIhE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,EACN,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAG5B,MAAM,YAAY,CAAA;AAMnB;;;;;;;;GAQG;AACH,MAAM,WAAW,8BAA8B;IAC9C,oEAAoE;IACpE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CACzB;AAUD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,CAK3E;AAED,qBAAa,wBAAyB,YAAW,oBAAoB;IAOnE,OAAO,CAAC,QAAQ,CAAC,GAAG;IANrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuB;gBAGpD,MAAM,EAAE,8BAA8B,EACtC,aAAa,CAAC,EAAE,qBAAqB,EACpB,GAAG,GAAE,MAAM,MAAiB;IAgB9C,OAAO,CAAC,MAAM;IAIR,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,eAAe,CAAC;IA6E5E,mBAAmB,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,KAAK,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC;CAavF"}
+{"version":3,"file":"disk.d.ts","sourceRoot":"","sources":["../../../src/store/feedback/disk.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAa,KAAK,EAAE,MAAM,0BAA0B,CAAA;AAYhE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,EACN,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAG5B,MAAM,YAAY,CAAA;AAenB;;;;;;;GAOG;AACH,MAAM,WAAW,8BAA8B;IAC9C,oEAAoE;IACpE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CACzB;AAUD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,CAO3E;AAED,qBAAa,wBAAyB,YAAW,oBAAoB;IAOnE,OAAO,CAAC,QAAQ,CAAC,GAAG;IANrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuB;gBAGpD,MAAM,EAAE,8BAA8B,EACtC,aAAa,CAAC,EAAE,qBAAqB,EACpB,GAAG,GAAE,MAAM,MAAiB;IAgB9C,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,QAAQ;IAahB,OAAO,CAAC,SAAS;IAgBX,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,eAAe,CAAC;IAyC5E,mBAAmB,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,KAAK,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC;CA4CvF"}

package/dist/store/feedback/disk.js

@@ -1,11 +1,18 @@
-import { mkdir, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
+import { NamzuError } from '../../types/errors/index.js';
+import { asMessageId, asRunId } from '../../utils/id.js';
 import { DiskRecordStore } from '../kv/record-store.js';
+import { DiskRevisionRecordStore, decodeRevisionFileSegment, legacyRevisionFileSegment, revisionFileSegment, } from '../kv/revision-record-store.js';
 import { readRunEventsIn } from '../run/disk.js';
-import { defineSchema, stamp } from '../schema.js';
+import { defineSchema } from '../schema.js';
 import { StaleFeedbackError, UnknownMessageError, } from './types.js';
-const SCHEMA = defineSchema({ kind: 'feedback-store', current: 1, migrations: {} });
+const SCHEMA = defineSchema({
+    kind: 'feedback-store',
+    current: 1,
+    migrations: {},
+});
 const records = new DiskRecordStore(SCHEMA);
+const revisionRecords = new DiskRevisionRecordStore(SCHEMA, 'message feedback store', (record) => record.ownerVersion);
 /** Filesystem-safe file name for one rated message. */
 function fileName(messageId) {
     // Message ids are `msg_` + an alphabet with no separators, so this is a
@@ -24,8 +31,10 @@ function fileName(messageId) {
  */
 export function runEventMessageCheck(runsDir) {
     return async (runId, messageId) => {
-        const events = await readRunEventsIn(join(runsDir, runId));
-        return events.some((event) => event.messageId === messageId);
+        const checkedRunId = asRunId(runId);
+        const checkedMessageId = asMessageId(messageId);
+        const events = await readRunEventsIn(join(runsDir, legacyRevisionFileSegment(checkedRunId)));
+        return events.some((event) => event.messageId === checkedMessageId);
     };
 }
 export class DiskMessageFeedbackStore {
@@ -48,92 +57,118 @@ export class DiskMessageFeedbackStore {
                     });
     }
     runDir(runId) {
-        return join(this.rootDir, runId);
+        return join(this.rootDir, legacyRevisionFileSegment(asRunId(runId)));
+    }
+    revisionsDir(runId) {
+        return join(this.runDir(runId), '.revisions');
+    }
+    location(runId, messageId) {
+        const checkedMessageId = asMessageId(messageId);
+        const legacyName = fileName(checkedMessageId);
+        return {
+            legacyPath: join(this.runDir(runId), legacyName),
+            revisionsDir: join(this.revisionsDir(runId), revisionFileSegment(checkedMessageId)),
+            // The previous filename replacement is lossy for punctuation and
+            // separators. Read such a legacy path forward if it exists, but never
+            // publish a new projection that could overwrite another message's file.
+            publishLegacyProjection: legacyName === `${checkedMessageId}.json`,
+        };
+    }
+    assertKey(record, runId, messageId) {
+        if (record.runId !== runId || record.messageId !== messageId) {
+            throw new NamzuError({
+                code: 'storage_error',
+                message: `Message feedback record key mismatch: expected ${runId}/${messageId}, found ${record.runId}/${record.messageId}. Repair or restore the record before retrying.`,
+                details: {
+                    expectedRunId: runId,
+                    expectedMessageId: messageId,
+                    actualRunId: record.runId,
+                    actualMessageId: record.messageId,
+                },
+                retryable: false,
+            });
+        }
     }
     async putMessageFeedback(input) {
+        // Runtime ids cross a public JS boundary. The nominal TypeScript brand can
+        // still be asserted, so validate before either an injected callback or a
+        // filesystem path sees the values.
+        const runId = asRunId(input.runId);
+        const messageId = asMessageId(input.messageId);
+        const location = this.location(runId, messageId);
         // Validated BEFORE the version check, so a rating aimed at a message
         // that does not exist is refused for what it is rather than reported
         // as a version conflict.
-        if (!(await this.messageExists(input.runId, input.messageId))) {
-            throw new UnknownMessageError({ runId: input.runId, messageId: input.messageId });
+        if (!(await this.messageExists(runId, messageId))) {
+            throw new UnknownMessageError({ runId, messageId });
         }
-        const dir = this.runDir(input.runId);
-        const path = join(dir, fileName(input.messageId));
-        const existing = await records.read(path);
-        const actualVersion = existing?.ownerVersion ?? 0;
-        if (input.expectedVersion !== actualVersion) {
-            throw new StaleFeedbackError({
-                runId: input.runId,
-                messageId: input.messageId,
-                expectedVersion: input.expectedVersion,
-                actualVersion,
-            });
-        }
-        const timestamp = this.now();
-        const record = {
-            runId: input.runId,
-            messageId: input.messageId,
-            rating: input.rating,
-            ...(input.note !== undefined ? { note: input.note } : {}),
-            ownerVersion: actualVersion + 1,
-            createdAt: existing?.createdAt ?? timestamp,
-            updatedAt: timestamp,
-        };
-        await mkdir(dir, { recursive: true });
-        if (actualVersion === 0) {
-            // EXCLUSIVE create for the first write, and this is the whole
-            // compare-and-set on a filesystem. A read-then-write is not
-            // atomic: two raters who each read "no feedback yet" both see
-            // version 0, both pass the check above, and both write — the
-            // second silently discarding the first. `wx` makes the kernel
-            // the arbiter, so exactly one of them lands.
-            //
-            // Found by the conformance suite on the day it was written, with
-            // the in-memory store passing the same rule for free because
-            // nothing awaits between its read and its write.
-            try {
-                await writeFile(path, `${JSON.stringify(stamp(SCHEMA, record), null, 2)}\n`, {
-                    encoding: 'utf-8',
-                    flag: 'wx',
-                });
-            }
-            catch (err) {
-                if (err.code !== 'EEXIST')
-                    throw err;
-                // Somebody else got there between the read and here. Report
-                // what is actually stored now, rather than the 0 we read.
-                const winner = await records.read(path);
+        return await revisionRecords.transact(location, (existing) => {
+            if (existing)
+                this.assertKey(existing, runId, messageId);
+            const actualVersion = existing?.ownerVersion ?? 0;
+            if (input.expectedVersion !== actualVersion) {
                 throw new StaleFeedbackError({
-                    runId: input.runId,
-                    messageId: input.messageId,
+                    runId,
+                    messageId,
                     expectedVersion: input.expectedVersion,
-                    actualVersion: winner?.ownerVersion ?? 1,
+                    actualVersion,
                 });
             }
-            return record;
-        }
-        // An UPDATE is written through the ordinary atomic replace. Two
-        // concurrent updates from separate PROCESSES can still interleave
-        // between the read above and this write — the file already exists, so
-        // there is no exclusive-create to arbitrate, and feedback carries no
-        // fencing token the way a run claim does. Said plainly rather than
-        // implied by the `expectedVersion` parameter, which reads like a
-        // stronger guarantee than a filesystem gives without one.
-        await records.write(path, record);
-        return record;
+            const timestamp = this.now();
+            const record = {
+                runId,
+                messageId,
+                rating: input.rating,
+                ...(input.note !== undefined ? { note: input.note } : {}),
+                ownerVersion: actualVersion + 1,
+                createdAt: existing?.createdAt ?? timestamp,
+                updatedAt: timestamp,
+            };
+            return { record, result: record };
+        });
     }
     async listMessageFeedback(query) {
-        const dir = this.runDir(query.runId);
-        const names = await records.scanNames(dir, '');
-        const out = [];
-        for (const name of names) {
+        const runId = asRunId(query.runId);
+        const dir = this.runDir(runId);
+        const ids = new Map();
+        // Old single-file records are still authoritative until their first
+        // current write. Read the body's id rather than attempting to reverse the
+        // old lossy filename mapping.
+        for (const name of await records.scanNames(dir, '')) {
             if (!name.endsWith('.json'))
                 continue;
             const record = await records.read(join(dir, name));
-            // A half-written entry from a crashed writer must not make the
-            // whole listing unavailable.
-            if (record !== null)
-                out.push(record);
+            if (record === null)
+                continue;
+            const messageId = asMessageId(record.messageId);
+            this.assertKey(record, runId, messageId);
+            if (fileName(messageId) !== name) {
+                throw new NamzuError({
+                    code: 'storage_error',
+                    message: `Message feedback projection filename ${name} does not match record ${messageId}. Repair or restore the record before retrying.`,
+                    details: { runId, messageId, name },
+                    retryable: false,
+                });
+            }
+            ids.set(messageId, messageId);
+        }
+        // The immutable commit is the success boundary. Projection publication is
+        // deliberately best-effort, so enumerate canonical revision directories
+        // too or a successful first rating can disappear after a crash.
+        for (const segment of await records.scanNames(this.revisionsDir(runId), '')) {
+            const decoded = decodeRevisionFileSegment(segment);
+            if (decoded === null)
+                continue;
+            const messageId = asMessageId(decoded);
+            ids.set(messageId, messageId);
+        }
+        const out = [];
+        for (const messageId of [...ids.values()].sort((a, b) => a.localeCompare(b))) {
+            const record = await revisionRecords.read(this.location(runId, messageId));
+            if (record === null)
+                continue;
+            this.assertKey(record, runId, messageId);
+            out.push(record);
         }
         return out;
     }

package/dist/store/feedback/disk.js.map

@@ -1 +1 @@
-{"version":3,"file":"disk.js","sourceRoot":"","sources":["../../../src/store/feedback/disk.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"disk.js","sourceRoot":"","sources":["../../../src/store/feedback/disk.ts"],"names":[],"mappings":"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"}

package/dist/store/goal/index.d.ts

@@ -0,0 +1,111 @@
+import type { GoalBlockReason, GoalPhase, GoalRef, GoalRoundAuthority, SessionGoal } from '../../types/goal/index.js';
+import type { GoalId, SessionId, TenantId } from '../../types/ids/index.js';
+import type { SessionStore } from '../../types/session/store.js';
+/** Current source-backed limit for a human goal objective. */
+export declare const MAX_GOAL_OBJECTIVE_CHARS = 4000;
+/** Source-aligned default; hosts may choose a smaller positive finite cap. */
+export declare const DEFAULT_MAX_GOAL_ROUNDS = 256;
+export interface CreateSessionGoalParams {
+    readonly sessionId: SessionId;
+    readonly objective: string;
+    readonly maxGoalRounds?: number;
+}
+export interface EditSessionGoalParams {
+    readonly objective: string;
+}
+export interface SessionGoalStore {
+    getGoal(sessionId: SessionId, tenantId: TenantId): Promise<SessionGoal | null>;
+    createGoal(params: CreateSessionGoalParams, tenantId: TenantId): Promise<SessionGoal>;
+    editGoal(sessionId: SessionId, tenantId: TenantId, ref: GoalRef, changes: EditSessionGoalParams): Promise<SessionGoal>;
+    pauseGoal(sessionId: SessionId, tenantId: TenantId, ref: GoalRef): Promise<SessionGoal>;
+    resumeGoal(sessionId: SessionId, tenantId: TenantId, ref: GoalRef): Promise<SessionGoal>;
+    /** Durably reserve one automatic round before any provider work begins. */
+    admitRound(sessionId: SessionId, tenantId: TenantId, ref: GoalRef): Promise<GoalRoundAuthority>;
+    completeGoal(sessionId: SessionId, tenantId: TenantId, ref: GoalRef): Promise<SessionGoal>;
+    blockGoal(sessionId: SessionId, tenantId: TenantId, ref: GoalRef, reason: GoalBlockReason): Promise<SessionGoal>;
+    clearGoal(sessionId: SessionId, tenantId: TenantId, ref: GoalRef): Promise<void>;
+}
+/** A mutation was based on a goal revision that is no longer current. */
+export declare class StaleGoalError extends Error {
+    readonly details: {
+        readonly sessionId: SessionId;
+        readonly expectedRevision: number;
+        readonly actualRevision: number;
+    };
+    constructor(details: StaleGoalError['details']);
+}
+/** A session already has a goal that has not completed or been cleared. */
+export declare class GoalExistsError extends Error {
+    readonly goal: SessionGoal;
+    constructor(goal: SessionGoal);
+}
+/** A goal operation was requested for a session with no current goal. */
+export declare class GoalNotFoundError extends Error {
+    readonly sessionId: SessionId;
+    constructor(sessionId: SessionId);
+}
+/** A goal transition is invalid from its current durable phase. */
+export declare class GoalTransitionError extends Error {
+    readonly phase: GoalPhase;
+    readonly operation: string;
+    constructor(phase: GoalPhase, operation: string);
+}
+/** Goal storage refuses ids that do not name a live tenant-owned Session. */
+export declare class GoalSessionNotFoundError extends Error {
+    readonly sessionId: SessionId;
+    constructor(sessionId: SessionId);
+}
+/** Admission reached its finite cap after durably blocking the goal. */
+export declare class GoalRoundLimitError extends Error {
+    readonly goal: SessionGoal;
+    constructor(goal: SessionGoal);
+}
+interface SessionGoalRecord {
+    readonly sessionId: SessionId;
+    readonly tenantId: TenantId;
+    /** Storage sequence survives clear and fresh goal identities. */
+    readonly storageRevision: number;
+    readonly goal: SessionGoal | null;
+    readonly updatedAt: number;
+}
+declare abstract class SessionGoalStoreBase implements SessionGoalStore {
+    protected readonly sessions: Pick<SessionStore, 'getSession'>;
+    protected readonly now: () => number;
+    protected readonly makeGoalId: () => GoalId;
+    protected constructor(sessions: Pick<SessionStore, 'getSession'>, now: () => number, makeGoalId: () => GoalId);
+    protected abstract put(record: SessionGoalRecord): Promise<void>;
+    private requireSession;
+    getGoal(sessionId: SessionId, tenantId: TenantId): Promise<SessionGoal | null>;
+    createGoal(params: CreateSessionGoalParams, tenantId: TenantId): Promise<SessionGoal>;
+    editGoal(sessionId: SessionId, tenantId: TenantId, ref: GoalRef, changes: EditSessionGoalParams): Promise<SessionGoal>;
+    pauseGoal(sessionId: SessionId, tenantId: TenantId, ref: GoalRef): Promise<SessionGoal>;
+    resumeGoal(sessionId: SessionId, tenantId: TenantId, ref: GoalRef): Promise<SessionGoal>;
+    admitRound(sessionId: SessionId, tenantId: TenantId, ref: GoalRef): Promise<GoalRoundAuthority>;
+    completeGoal(sessionId: SessionId, tenantId: TenantId, ref: GoalRef): Promise<SessionGoal>;
+    blockGoal(sessionId: SessionId, tenantId: TenantId, ref: GoalRef, reason: GoalBlockReason): Promise<SessionGoal>;
+    clearGoal(sessionId: SessionId, tenantId: TenantId, ref: GoalRef): Promise<void>;
+    private transition;
+    private mutate;
+}
+export interface InMemorySessionGoalStoreConfig {
+    readonly sessions: Pick<SessionStore, 'getSession'>;
+}
+export declare class InMemorySessionGoalStore extends SessionGoalStoreBase {
+    private readonly records;
+    constructor(config: InMemorySessionGoalStoreConfig, now?: () => number, makeGoalId?: () => GoalId);
+    protected put(record: SessionGoalRecord): Promise<void>;
+}
+export interface DiskSessionGoalStoreConfig {
+    /** Session root; goals live under `<rootDir>/goals/`. */
+    readonly rootDir: string;
+    /** Authority for session existence and tenant ownership. */
+    readonly sessions: Pick<SessionStore, 'getSession'>;
+}
+export declare class DiskSessionGoalStore extends SessionGoalStoreBase {
+    private readonly config;
+    constructor(config: DiskSessionGoalStoreConfig, now?: () => number, makeGoalId?: () => GoalId);
+    private location;
+    protected put(record: SessionGoalRecord): Promise<void>;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/store/goal/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/store/goal/index.ts"],"names":[],"mappings":"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"}