@cotal-ai/core 0.66.1 → 0.67.0

package/dist/transfer.d.ts

@@ -0,0 +1,110 @@
+import { type NatsConnection } from "@nats-io/nats-core";
+import { type JetStreamManager } from "@nats-io/jetstream";
+/** The stock client's default chunk, and the most a chunk carries. */
+export declare const TRANSFER_CHUNK_MAX: number;
+/** Transcript bytes acknowledged through a chunk. */
+export declare const OFFSET_HEADER = "Cotal-Offset";
+/** Chunks acknowledged through a chunk. */
+export declare const CHUNK_HEADER = "Cotal-Chunk";
+/** `$O.<bucket>.C.<hex>`: one stable chunk subject per transcript, so every attempt at the same bytes
+ *  extends the same chain. */
+export declare function transferChunkSubject(bucket: string, hex: string): string;
+/** `$O.<bucket>.M.<name>`, the name encoded as the stock client encodes it. */
+export declare function transferMetaSubject(bucket: string, hex: string): string;
+/**
+ * Create the instance's transfer bucket, or verify one that exists, and return its name. Same
+ * discipline as `ensureArtifactStore`: a store that exists under the name with other bounds is
+ * refused rather than adopted. `max_age` must be 0, because a per-message age can drop the start of
+ * a chain and keep its end (design section 4.5); direct get must be on, because the hit check and the
+ * resume read use it.
+ */
+export declare function ensureTransferStore(nc: NatsConnection, space: string, instanceId: string): Promise<string>;
+/**
+ * The operator's transfer instrument (design section 6): publish the one object's chunk and meta
+ * subjects in one instance's bucket, and read the last message of each with a direct get. It names
+ * no other object, no stream API beyond those two reads, and no consumer, so a copied instrument can
+ * extend or commit only the transcript the CLI hashed before minting it.
+ */
+export declare function transferWriterGrants(space: string, instanceId: string, hex: string, connId: string): {
+    publish: string[];
+    subscribe: string[];
+};
+/**
+ * A manager instance's transfer reader (design section 6): create and read its own bucket's stream,
+ * stream it through the stock `get`'s push consumer, and remove a transfer with the stock delete
+ * marker and a filtered purge. Every row names the instance's own stream, so it reads no other
+ * instance's transfers. The push consumer delivers to this connection's own inbox, and a caller-chosen
+ * `deliver_subject` could only export the bucket this reader is already entitled to.
+ */
+export declare function transferReaderGrants(space: string, instanceId: string, connId: string): {
+    publish: string[];
+    subscribe: string[];
+};
+/** How far a chain got: the last chunk's headers and stream sequence, or all zero for no chain. */
+export interface ChainHead {
+    offset: number;
+    chunks: number;
+    seq: number;
+}
+/** Which read a caller's grant allows: the writer holds last-by-subject direct gets on its two
+ *  subjects, the target's reader holds `STREAM.MSG.GET` on its own stream (design section 6). */
+export type TransferRead = "direct" | "stream";
+/** Read the last chunk on the transcript's chunk subject: the writer's resume point. */
+export declare function readChainHead(jsm: JetStreamManager, bucket: string, hex: string): Promise<ChainHead>;
+/** The meta subject's last message: its sequence (0 for none) and whether it is a live record. */
+export interface MetaHead {
+    seq: number;
+    live: boolean;
+    /** The record's chunk subject token (a stock delete marker keeps it) and the live record's chunk count. */
+    nuid?: string;
+    chunks?: number;
+    digest?: string;
+}
+export declare function readMetaHead(jsm: JetStreamManager, bucket: string, hex: string, read: TransferRead): Promise<MetaHead>;
+/** How one write pass ended. Every outcome but `live` is followed by `transcript-receive`, whose answer
+ *  ends the write (design 4.3); `live` is another writer's commit, which the target fetches. */
+export type WriteOutcome = {
+    state: "committed" | "refused" | "removed" | "live";
+    sent: number;
+    chunks: number;
+};
+/**
+ * One pass of the writer (design 4.2-4.4): skip to the target on a live record, continue the chain from
+ * its head, and commit. A refused chunk expectation rereads the head and continues when a chunk is
+ * left; an empty subject means the target removed the transfer, which only the target can resolve.
+ * `sent` and `chunks` count what this pass published.
+ */
+export declare function writeTransfer(nc: NatsConnection, bucket: string, bytes: Uint8Array): Promise<WriteOutcome>;
+/**
+ * Remove a transfer whole (design 4.5): the stock delete for a live record (its marker, then one
+ * filtered purge of the record's chunk subject), otherwise the purge alone of each chunk subject that
+ * holds a message: the chain's, and the one a delete marker names, whose chunks remain when a stop fell
+ * between the marker and its purge (a stock put names a random one). A transfer with neither is already
+ * removed and nothing is written, because a stock delete of a deleted record publishes another marker.
+ */
+export declare function removeTransfer(nc: NatsConnection, bucket: string, hex: string): Promise<void>;
+/** One transfer the sweep found: its digest and when its last message was written. */
+export interface TransferEntry {
+    hex: string;
+    lastWrite: Date;
+}
+/** Every transfer in the bucket, listed from the stream's subjects and the last message of each. */
+export declare function listTransfers(nc: NatsConnection, bucket: string): Promise<TransferEntry[]>;
+/** What fetching a committed object found. */
+export type FetchOutcome = {
+    state: "absent";
+} | {
+    state: "fetched";
+    bytes: Uint8Array;
+} | {
+    state: "invalid";
+    reason: string;
+};
+/**
+ * Read a committed object with the stock `get` and check it against the requested digest. The chunk
+ * count is checked first, because the stock `get` of a record whose chunks were swept waits for them
+ * and never returns (design 4.5). The record is the writer's claim: the stock `get` recomputes the
+ * digest over what it streams, and the record's own digest must name the bytes the operator asked for.
+ */
+export declare function fetchTransfer(nc: NatsConnection, bucket: string, hex: string): Promise<FetchOutcome>;
+//# sourceMappingURL=transfer.d.ts.map

package/dist/transfer.d.ts.map

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

package/dist/transfer.js

@@ -0,0 +1,325 @@
+/**
+ * The resume transfer store: a carried transcript's path from the operator's host to one manager
+ * instance (docs/design/resume-transfer.md sections 3 and 4).
+ *
+ * Objects are written in the stock Object Store layout so the stock `get` reads and verifies them,
+ * but never with the stock `put`: that draws a random chunk subject per call and purges what it wrote
+ * on any error, so an interrupted upload could only restart from byte zero. Here the chunk subject is
+ * derived from the digest and every chunk publish is pinned to the previous one's stream sequence, so
+ * the broker's chain is the checkpoint and any writer of the same bytes continues it.
+ */
+import { createHash } from "node:crypto";
+import { headers } from "@nats-io/nats-core";
+import { jetstream, jetstreamManager } from "@nats-io/jetstream";
+import { Objm } from "@nats-io/obj";
+import { objectStoreStream, transferBucket } from "./subjects.js";
+import { fromObjectStoreDigest } from "./artifact.js";
+import { isCasLoss } from "./endpoint-records.js";
+/** The stock client's default chunk, and the most a chunk carries. */
+export const TRANSFER_CHUNK_MAX = 128 * 1024;
+/** Room left under `max_payload` for the publish's headers. */
+const HEADER_ROOM = 4 * 1024;
+/** Transcript bytes acknowledged through a chunk. */
+export const OFFSET_HEADER = "Cotal-Offset";
+/** Chunks acknowledged through a chunk. */
+export const CHUNK_HEADER = "Cotal-Chunk";
+const EXPECTED_LAST_SUBJECT_SEQ = "Nats-Expected-Last-Subject-Sequence";
+const HEX64 = /^[0-9a-f]{64}$/;
+/** A record's chunk subject token: this protocol's hex digest or the stock client's nuid, never a wildcard. */
+const STOCK_NUID = /^[0-9A-Za-z]{1,64}$/;
+function assertHex(hex) {
+    if (!HEX64.test(hex))
+        throw new Error(`transfer: ${JSON.stringify(hex)} is not a 64-character lowercase hex digest`);
+}
+/** Base64url with its padding kept, the stock client's encoding for meta subjects and digests. */
+function paddedBase64Url(bytes) {
+    return bytes.toString("base64").replace(/\+/g, "-").replace(/\//g, "_");
+}
+/** `$O.<bucket>.C.<hex>`: one stable chunk subject per transcript, so every attempt at the same bytes
+ *  extends the same chain. */
+export function transferChunkSubject(bucket, hex) {
+    assertHex(hex);
+    return `$O.${bucket}.C.${hex}`;
+}
+/** `$O.<bucket>.M.<name>`, the name encoded as the stock client encodes it. */
+export function transferMetaSubject(bucket, hex) {
+    assertHex(hex);
+    return `$O.${bucket}.M.${paddedBase64Url(Buffer.from(`sha256:${hex}`))}`;
+}
+/**
+ * Create the instance's transfer bucket, or verify one that exists, and return its name. Same
+ * discipline as `ensureArtifactStore`: a store that exists under the name with other bounds is
+ * refused rather than adopted. `max_age` must be 0, because a per-message age can drop the start of
+ * a chain and keep its end (design section 4.5); direct get must be on, because the hit check and the
+ * resume read use it.
+ */
+export async function ensureTransferStore(nc, space, instanceId) {
+    const bucket = transferBucket(space, instanceId);
+    const stream = objectStoreStream(bucket);
+    const jsm = await jetstreamManager(nc);
+    await new Objm(jetstream(nc)).create(bucket, { max_bytes: -1 });
+    const { config } = await jsm.streams.info(stream);
+    const drift = [];
+    const want = [`$O.${bucket}.C.>`, `$O.${bucket}.M.>`];
+    if (JSON.stringify(config.subjects ?? []) !== JSON.stringify(want))
+        drift.push(`subjects are ${JSON.stringify(config.subjects ?? [])}, expected ${JSON.stringify(want)}`);
+    if (config.mirror)
+        drift.push("it is a MIRROR of another stream");
+    if (config.sources?.length)
+        drift.push(`it SOURCES ${config.sources.length} other stream(s)`);
+    if (String(config.discard) !== "new")
+        drift.push(`discard is ${config.discard}, expected new`);
+    if (String(config.storage) !== "file")
+        drift.push(`storage is ${config.storage}, expected file`);
+    if (String(config.retention) !== "limits")
+        drift.push(`retention is ${config.retention}, expected limits`);
+    if (config.allow_rollup_hdrs !== true)
+        drift.push("allow_rollup_hdrs is false, expected true (the commit is a subject rollup)");
+    if (config.allow_direct !== true)
+        drift.push("allow_direct is false, expected true (the hit and resume reads are direct gets)");
+    if (config.max_age !== 0)
+        drift.push(`max_age is ${config.max_age}, expected 0 (an age can drop the start of a chain and keep its end)`);
+    if (config.sealed === true)
+        drift.push("the stream is SEALED (writes permanently refused)");
+    for (const [field, value] of [["max_bytes", config.max_bytes], ["max_msgs", config.max_msgs],
+        ["max_msgs_per_subject", config.max_msgs_per_subject], ["max_msg_size", config.max_msg_size]])
+        if (value !== -1)
+            drift.push(`${field} is ${value}, expected -1`);
+    if (drift.length)
+        throw new Error(`transfer store ${stream} has drifted: ${drift.join("; ")} - refusing to adopt it (delete it, or reconcile it deliberately)`);
+    return bucket;
+}
+/**
+ * The operator's transfer instrument (design section 6): publish the one object's chunk and meta
+ * subjects in one instance's bucket, and read the last message of each with a direct get. It names
+ * no other object, no stream API beyond those two reads, and no consumer, so a copied instrument can
+ * extend or commit only the transcript the CLI hashed before minting it.
+ */
+export function transferWriterGrants(space, instanceId, hex, connId) {
+    const bucket = transferBucket(space, instanceId);
+    const subjects = [transferChunkSubject(bucket, hex), transferMetaSubject(bucket, hex)];
+    const direct = `$JS.API.DIRECT.GET.${objectStoreStream(bucket)}`;
+    return { publish: [...subjects, ...subjects.map((s) => `${direct}.${s}`)], subscribe: [`_INBOX_${connId}.>`] };
+}
+/**
+ * A manager instance's transfer reader (design section 6): create and read its own bucket's stream,
+ * stream it through the stock `get`'s push consumer, and remove a transfer with the stock delete
+ * marker and a filtered purge. Every row names the instance's own stream, so it reads no other
+ * instance's transfers. The push consumer delivers to this connection's own inbox, and a caller-chosen
+ * `deliver_subject` could only export the bucket this reader is already entitled to.
+ */
+export function transferReaderGrants(space, instanceId, connId) {
+    const bucket = transferBucket(space, instanceId);
+    const stream = objectStoreStream(bucket);
+    return {
+        publish: [
+            // The stock Object Store client opens its manager with the account API check.
+            "$JS.API.INFO",
+            `$JS.API.STREAM.CREATE.${stream}`,
+            `$JS.API.STREAM.INFO.${stream}`,
+            `$JS.API.STREAM.MSG.GET.${stream}`,
+            `$JS.API.STREAM.PURGE.${stream}`,
+            `$JS.API.CONSUMER.CREATE.${stream}`,
+            `$JS.API.CONSUMER.CREATE.${stream}.>`,
+            `$O.${bucket}.M.>`,
+            // Flow control replies of the stock get's push consumer, which the broker names by stream.
+            `$JS.FC.${stream}.>`,
+        ],
+        subscribe: [`_INBOX_${connId}.>`],
+    };
+}
+function lastOnSubject(jsm, stream, subject, read) {
+    return read === "direct"
+        ? jsm.direct.getMessage(stream, { last_by_subj: subject })
+        : jsm.streams.getMessage(stream, { last_by_subj: subject });
+}
+/** Read the last chunk on the transcript's chunk subject: the writer's resume point. */
+export async function readChainHead(jsm, bucket, hex) {
+    const m = await lastOnSubject(jsm, objectStoreStream(bucket), transferChunkSubject(bucket, hex), "direct");
+    if (m === null)
+        return { offset: 0, chunks: 0, seq: 0 };
+    const offset = Number(m.header.get(OFFSET_HEADER));
+    const chunks = Number(m.header.get(CHUNK_HEADER));
+    if (!Number.isSafeInteger(offset) || offset <= 0 || !Number.isSafeInteger(chunks) || chunks <= 0)
+        throw new Error(`transfer chunk ${m.subject}#${m.seq} carries no valid ${OFFSET_HEADER}/${CHUNK_HEADER} headers`);
+    return { offset, chunks, seq: m.seq };
+}
+export async function readMetaHead(jsm, bucket, hex, read) {
+    const m = await lastOnSubject(jsm, objectStoreStream(bucket), transferMetaSubject(bucket, hex), read);
+    if (m === null)
+        return { seq: 0, live: false };
+    const info = JSON.parse(m.string());
+    if (info.deleted === true)
+        return { seq: m.seq, live: false, nuid: info.nuid };
+    return { seq: m.seq, live: true, nuid: info.nuid, chunks: info.chunks, digest: info.digest };
+}
+/** The connection's chunk size: the stock default, lowered to fit `max_payload`. */
+function chunkSize(nc) {
+    const maxPayload = nc.info?.max_payload;
+    if (!maxPayload)
+        throw new Error("transfer: the connection reports no max_payload");
+    const size = Math.min(TRANSFER_CHUNK_MAX, maxPayload - HEADER_ROOM);
+    if (size <= 0)
+        throw new Error(`transfer: max_payload ${maxPayload} leaves no room for a chunk`);
+    return size;
+}
+/**
+ * One pass of the writer (design 4.2-4.4): skip to the target on a live record, continue the chain from
+ * its head, and commit. A refused chunk expectation rereads the head and continues when a chunk is
+ * left; an empty subject means the target removed the transfer, which only the target can resolve.
+ * `sent` and `chunks` count what this pass published.
+ */
+export async function writeTransfer(nc, bucket, bytes) {
+    const digest = createHash("sha256").update(bytes).digest();
+    const hex = digest.toString("hex");
+    // The writer's instrument holds its two direct gets and nothing else on the JetStream API.
+    const jsm = await jetstreamManager(nc, { checkAPI: false });
+    const js = jetstream(nc);
+    const meta = await readMetaHead(jsm, bucket, hex, "direct");
+    if (meta.live)
+        return { state: "live", sent: 0, chunks: 0 };
+    const subject = transferChunkSubject(bucket, hex);
+    const max = chunkSize(nc);
+    let head = await readChainHead(jsm, bucket, hex);
+    let sent = 0;
+    let published = 0;
+    while (head.offset < bytes.length) {
+        const end = Math.min(head.offset + max, bytes.length);
+        const h = headers();
+        h.set(OFFSET_HEADER, String(end));
+        h.set(CHUNK_HEADER, String(head.chunks + 1));
+        h.set(EXPECTED_LAST_SUBJECT_SEQ, String(head.seq));
+        try {
+            const ack = await js.publish(subject, bytes.subarray(head.offset, end), { headers: h });
+            sent += end - head.offset;
+            published++;
+            head = { offset: end, chunks: head.chunks + 1, seq: ack.seq };
+        }
+        catch (e) {
+            if (!isCasLoss(e))
+                throw e;
+            head = await readChainHead(jsm, bucket, hex);
+            if (head.seq === 0)
+                return { state: "removed", sent, chunks: published };
+        }
+    }
+    const record = {
+        name: `sha256:${hex}`,
+        bucket,
+        nuid: hex,
+        size: bytes.length,
+        chunks: head.chunks,
+        mtime: new Date().toISOString(),
+        deleted: false,
+        options: { max_chunk_size: max },
+        digest: `SHA-256=${paddedBase64Url(digest)}`,
+    };
+    const h = headers();
+    h.set("Nats-Rollup", "sub");
+    h.set(EXPECTED_LAST_SUBJECT_SEQ, String(meta.seq));
+    try {
+        await js.publish(transferMetaSubject(bucket, hex), JSON.stringify(record), { headers: h });
+    }
+    catch (e) {
+        if (!isCasLoss(e))
+            throw e;
+        return { state: "refused", sent, chunks: published };
+    }
+    return { state: "committed", sent, chunks: published };
+}
+/** Messages held on one subject, read with `STREAM.INFO` and `subjects_filter`. */
+async function subjectCount(jsm, stream, subject) {
+    const info = await jsm.streams.info(stream, { subjects_filter: subject });
+    return info.state.subjects?.[subject] ?? 0;
+}
+/**
+ * Remove a transfer whole (design 4.5): the stock delete for a live record (its marker, then one
+ * filtered purge of the record's chunk subject), otherwise the purge alone of each chunk subject that
+ * holds a message: the chain's, and the one a delete marker names, whose chunks remain when a stop fell
+ * between the marker and its purge (a stock put names a random one). A transfer with neither is already
+ * removed and nothing is written, because a stock delete of a deleted record publishes another marker.
+ */
+export async function removeTransfer(nc, bucket, hex) {
+    const jsm = await jetstreamManager(nc);
+    const meta = await readMetaHead(jsm, bucket, hex, "stream");
+    if (meta.live) {
+        await (await new Objm(jetstream(nc)).open(bucket)).delete(`sha256:${hex}`);
+        return;
+    }
+    const stream = objectStoreStream(bucket);
+    const marked = meta.nuid !== undefined && STOCK_NUID.test(meta.nuid) ? [`$O.${bucket}.C.${meta.nuid}`] : [];
+    for (const subject of new Set([transferChunkSubject(bucket, hex), ...marked]))
+        if ((await subjectCount(jsm, stream, subject)) > 0)
+            await jsm.streams.purge(stream, { filter: subject });
+}
+/** Every transfer in the bucket, listed from the stream's subjects and the last message of each. */
+export async function listTransfers(nc, bucket) {
+    const jsm = await jetstreamManager(nc);
+    const stream = objectStoreStream(bucket);
+    const chunkPrefix = `$O.${bucket}.C.`;
+    const metaPrefix = `$O.${bucket}.M.`;
+    const info = await jsm.streams.info(stream, { subjects_filter: `$O.${bucket}.>` });
+    const last = new Map();
+    for (const subject of Object.keys(info.state.subjects ?? {})) {
+        let hex;
+        if (subject.startsWith(chunkPrefix))
+            hex = subject.slice(chunkPrefix.length);
+        else if (subject.startsWith(metaPrefix)) {
+            const name = Buffer.from(subject.slice(metaPrefix.length), "base64url").toString();
+            if (!name.startsWith("sha256:"))
+                continue;
+            hex = name.slice("sha256:".length);
+        }
+        else
+            continue;
+        if (!HEX64.test(hex))
+            continue;
+        const m = await lastOnSubject(jsm, stream, subject, "stream");
+        if (m === null)
+            continue;
+        const at = m.time;
+        const seen = last.get(hex);
+        if (!seen || at > seen)
+            last.set(hex, at);
+    }
+    return [...last].map(([hex, lastWrite]) => ({ hex, lastWrite }));
+}
+/**
+ * Read a committed object with the stock `get` and check it against the requested digest. The chunk
+ * count is checked first, because the stock `get` of a record whose chunks were swept waits for them
+ * and never returns (design 4.5). The record is the writer's claim: the stock `get` recomputes the
+ * digest over what it streams, and the record's own digest must name the bytes the operator asked for.
+ */
+export async function fetchTransfer(nc, bucket, hex) {
+    const jsm = await jetstreamManager(nc);
+    const meta = await readMetaHead(jsm, bucket, hex, "stream");
+    if (!meta.live)
+        return { state: "absent" };
+    if (meta.nuid === undefined || !HEX64.test(meta.nuid) || meta.chunks === undefined)
+        return { state: "invalid", reason: "the record names no chunk subject or chunk count" };
+    const held = await subjectCount(jsm, objectStoreStream(bucket), `$O.${bucket}.C.${meta.nuid}`);
+    if (held !== meta.chunks)
+        return { state: "invalid", reason: `the record names ${meta.chunks} chunks and ${held} are held` };
+    let recorded;
+    try {
+        recorded = fromObjectStoreDigest(meta.digest ?? "");
+    }
+    catch (e) {
+        return { state: "invalid", reason: e.message };
+    }
+    if (recorded !== `sha256:${hex}`)
+        return { state: "invalid", reason: `the record's digest is ${recorded}` };
+    const os = await new Objm(jetstream(nc)).open(bucket);
+    try {
+        const bytes = await os.getBlob(`sha256:${hex}`);
+        if (bytes === null)
+            return { state: "absent" };
+        if (createHash("sha256").update(bytes).digest("hex") !== hex)
+            return { state: "invalid", reason: "the bytes read do not hash to the name" };
+        return { state: "fetched", bytes };
+    }
+    catch (e) {
+        return { state: "invalid", reason: e.message };
+    }
+}
+//# sourceMappingURL=transfer.js.map

package/dist/transfer.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cotal-ai/core",
   "description": "The Cotal protocol: endpoint, subjects, message types, the NATS client layer, and the extension contracts.",
-  "version": "0.66.1",
+  "version": "0.67.0",
   "license": "Apache-2.0",
   "keywords": [
     "cotal",