@kaana.ai/contracts 4.4.0 → 4.4.1

package/dist/internal/settlement.d.ts

@@ -111,6 +111,21 @@ export declare const settlementAcknowledgementSchema: z.ZodObject<{
         settled: "settled";
     }>;
 }, z.core.$strict>;
+/**
+ * The signature domain of Oxy's reconciliation read, under the Oxy edge key
+ * (`KAANA_EDGE_PUBLIC_KEYS`). New in package 4.4.1; Kaana has verified under it
+ * since contract set 4.2.0.
+ */
+export declare const SETTLEMENT_READ_SIGNATURE_DOMAIN = "oxy-kaana-settlement-read:v1";
+/** Where Oxy reads the outbox, on `https://kaana.ai`. */
+export declare const SETTLEMENT_READ_PATH = "/internal/v1/settlements";
+/**
+ * The query string of a reconciliation read, without its `?`: both what Oxy
+ * sends and the exact bytes it signs. Kaana verifies the raw query and nothing
+ * else — the path is fixed by the domain — so signing `path?query`, or encoding
+ * the cursor differently from what is sent, is refused as unsigned.
+ */
+export declare function settlementReadQuery(cursor: string | null): string;
 /** `GET /internal/v1/settlements?cursor=`: what Oxy reconciles against. */
 export declare const settlementPageSchema: z.ZodObject<{
     data: z.ZodArray<z.ZodObject<{

package/dist/internal/settlement.js

@@ -61,6 +61,23 @@ export const settlementAcknowledgementSchema = z
     status: z.enum(['settled', 'duplicate']),
 })
     .strict();
+/**
+ * The signature domain of Oxy's reconciliation read, under the Oxy edge key
+ * (`KAANA_EDGE_PUBLIC_KEYS`). New in package 4.4.1; Kaana has verified under it
+ * since contract set 4.2.0.
+ */
+export const SETTLEMENT_READ_SIGNATURE_DOMAIN = 'oxy-kaana-settlement-read:v1';
+/** Where Oxy reads the outbox, on `https://kaana.ai`. */
+export const SETTLEMENT_READ_PATH = '/internal/v1/settlements';
+/**
+ * The query string of a reconciliation read, without its `?`: both what Oxy
+ * sends and the exact bytes it signs. Kaana verifies the raw query and nothing
+ * else — the path is fixed by the domain — so signing `path?query`, or encoding
+ * the cursor differently from what is sent, is refused as unsigned.
+ */
+export function settlementReadQuery(cursor) {
+    return cursor === null ? '' : `cursor=${encodeURIComponent(cursor)}`;
+}
 /** `GET /internal/v1/settlements?cursor=`: what Oxy reconciles against. */
 export const settlementPageSchema = z
     .object({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaana.ai/contracts",
-  "version": "4.4.0",
+  "version": "4.4.1",
   "description": "Kaana inference contract: the Zod schemas of the public API at https://kaana.ai/v1 and, under /internal, of the Oxy-Kaana grant, settlement and signed lane.",
   "type": "module",
   "sideEffects": false,