@catalyst-cloud/sdk 0.9.1 → 0.10.0

package/README.md

@@ -244,6 +244,32 @@ switch (moved.outcome) {
 
 The contract cache is in memory per client by default; pass `contractCache: { get, set }` to keep it on disk (the bundle does). `fetch`, `now` and `timeoutMs` are injectable so a test never opens a socket.
 
+### Durable event cache for node and Bun
+
+`@catalyst-cloud/sdk/events` mirrors the tenant's exact durable Catalyst event backbone into an append-only local cache. It uses bounded HTTP replay with an idle backoff; local consumers tail files and never poll GitHub, Linear, or cloud tables. Start and stop it with the process that currently needs the tenant instead of installing another permanent daemon.
+
+```ts
+import { CatalystEventSync, tailCachedEvents } from "@catalyst-cloud/sdk/events";
+
+const sync = new CatalystEventSync({
+  baseUrl: "https://staging.catalystcloud.dev",
+  auth: { kind: "token", token: process.env.CATALYST_CLOUD_TOKEN! },
+  tenantId: "tenant-1",
+});
+const running = sync.start();
+for await (const event of tailCachedEvents({ tenantId: "tenant-1", signal })) {
+  console.log(event.type, event.sequence);
+}
+await sync.stop();
+await running;
+```
+
+The default path is `$XDG_STATE_HOME/catalyst/events/<tenant>/backbone/`, falling back to `~/.local/state/catalyst/events/<tenant>/backbone/`. Daily `YYYY-MM-DD[-NNN].jsonl` segments contain the cloud's `CatalystEvent` envelope unchanged. `cursor.json` is owned by the one sync writer; readers keep their own offsets elsewhere and do not write into this directory. The stable replay identity is `(tenantId, sequence, eventId)`.
+
+The writer fsyncs appended records before atomically advancing its cursor. On restart it truncates an incomplete final line and derives the resume cursor from the last complete record, making a crash between append and checkpoint safe. Server archive gaps and reads behind the local retention floor raise `EventHistoryGapError` with the head, suggested resume point, and reason; the SDK does not silently skip history. New caches bootstrap at the current backbone head. Closed daily segments are retained for seven days or until the cache reaches 256 MiB, whichever happens first. The active segment rotates before the same byte bound, so it cannot grow without limit; `retainDays` and `maxCacheBytes` configure these bounds.
+
+This API only reads the durable backbone. It does not publish events or treat raw provider events, the legacy coordination feed, or analytical samples as execution or billing authority. Use the existing authorized cloud operations to report outcomes and changes.
+
 ## API
 
 | Export | What it is |
@@ -256,6 +282,7 @@ The contract cache is in memory per client by default; pass `contractCache: { ge
 | `createTenantClient` | The typed HTTP client — `contract()`, `me()`, `issues.list/get`, `pulls.list/get`, `projects.list`, `agent.*` (issueState, issueLabel, issueComment, issueCreate, reaction, attachment, attachments, session, ask, askAccept). |
 | `TenantContract` · `routeByName` · `teamByKey` · `teamForTicket` · `stageIdForSlot` · `labelIdFor` | The contract document's shape and the pure accessors over it, each returning a typed miss rather than throwing. |
 | `TenantClientFailure` · `PageCursor` · `pageCursor` · `memoryContractCache` | The shared failure arms, the opaque page token, and the default contract cache store. |
+| `CatalystEventSync` · `readCachedEvents` · `tailCachedEvents` · `EventHistoryGapError` | Node/Bun durable-backbone replay, local cache readers, and explicit history-gap handling from `@catalyst-cloud/sdk/events`. |
 
 `start()` resolves only when `stop()` is called. On a backend, `await` it to keep the process alive; in a browser, never await it — just call `stop()` on teardown.
 

package/dist/events.d.ts

@@ -0,0 +1,79 @@
+import type { CatalystEvent } from "@catalyst-cloud/schema";
+import type { AuthStrategy } from "./live-sync-client.js";
+import { type WriterGuardOptions } from "./replica/writer-lock.js";
+export type { CatalystEvent } from "@catalyst-cloud/schema";
+export interface EventCachePaths {
+    directory: string;
+    cursor: string;
+    lock: string;
+}
+export interface EventSyncOptions {
+    baseUrl: string;
+    auth: Exclude<AuthStrategy, {
+        kind: "cookie";
+    }>;
+    tenantId: string;
+    directory?: string;
+    fetch?: typeof fetch;
+    requestTimeoutMs?: number;
+    idleMinMs?: number;
+    idleMaxMs?: number;
+    retainDays?: number;
+    maxCacheBytes?: number;
+    writerGuard?: WriterGuardOptions;
+    now?: () => Date;
+    sleep?: (ms: number, signal: AbortSignal) => Promise<void>;
+}
+export interface EventSyncStatus {
+    state: "idle" | "syncing" | "stopped" | "failed";
+    cursor: number | null;
+    head: number | null;
+    lastSyncAt: string | null;
+    error: string | null;
+}
+export interface EventSyncResult {
+    appended: number;
+    cursor: number;
+    head: number;
+}
+export declare class EventHistoryGapError extends Error {
+    readonly head: number;
+    readonly resumeFrom: number;
+    readonly reason: string;
+    constructor(message: string, head: number, resumeFrom: number, reason: string);
+}
+export declare function defaultEventCacheDirectory(tenantId: string): string;
+export declare function eventCachePaths(tenantId: string, directory?: string): EventCachePaths;
+export declare class CatalystEventSync {
+    private readonly options;
+    readonly paths: EventCachePaths;
+    private readonly fetchImpl;
+    private readonly now;
+    private readonly sleeper;
+    private lock;
+    private controller;
+    private running;
+    private recoveredCursor;
+    private floor;
+    private current;
+    constructor(options: EventSyncOptions);
+    status(): EventSyncStatus;
+    syncOnce(signal?: AbortSignal): Promise<EventSyncResult>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private loop;
+    private request;
+    private readCurrentHead;
+    private readPage;
+}
+export interface ReadCachedEventsOptions {
+    tenantId: string;
+    directory?: string;
+    after?: number;
+}
+export declare function readCachedEvents(options: ReadCachedEventsOptions): Promise<CatalystEvent[]>;
+export declare function tailCachedEvents(options: ReadCachedEventsOptions & {
+    signal: AbortSignal;
+}): AsyncGenerator<CatalystEvent>;
+export declare function eventIdentity(event: CatalystEvent): string;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

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

package/dist/events.js

@@ -0,0 +1,492 @@
+import { mkdir, open, readFile, readdir, rename, rm, stat, truncate, watch, writeFile, } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { claimWriterLock, } from "./replica/writer-lock.js";
+const HEAD_HEADER = "x-catalyst-event-backbone-head-seq";
+const MAX_EVENT_LINE_BYTES = 1024 * 1024;
+const DEFAULT_REQUEST_TIMEOUT_MS = 15_000;
+const DEFAULT_IDLE_MIN_MS = 1_000;
+const DEFAULT_IDLE_MAX_MS = 30_000;
+const DEFAULT_RETAIN_DAYS = 7;
+const DEFAULT_MAX_CACHE_BYTES = 256 * 1024 * 1024;
+const SEGMENT_PATTERN = /^\d{4}-\d{2}-\d{2}(?:-\d{3})?\.jsonl$/;
+export class EventHistoryGapError extends Error {
+    head;
+    resumeFrom;
+    reason;
+    constructor(message, head, resumeFrom, reason) {
+        super(message);
+        this.head = head;
+        this.resumeFrom = resumeFrom;
+        this.reason = reason;
+        this.name = "EventHistoryGapError";
+    }
+}
+class EventSyncHttpError extends Error {
+    status;
+    constructor(status) {
+        super(`event sync: backbone returned ${status}`);
+        this.status = status;
+        this.name = "EventSyncHttpError";
+    }
+}
+export function defaultEventCacheDirectory(tenantId) {
+    const state = globalThis
+        .process?.env?.XDG_STATE_HOME || join(homedir(), ".local", "state");
+    return join(state, "catalyst", "events", tenantId, "backbone");
+}
+export function eventCachePaths(tenantId, directory) {
+    const root = directory ?? defaultEventCacheDirectory(tenantId);
+    return {
+        directory: root,
+        cursor: join(root, "cursor.json"),
+        lock: join(root, ".sync"),
+    };
+}
+function positiveInteger(value, name) {
+    if ((typeof value !== "string" && typeof value !== "number") ||
+        String(value).trim() === "")
+        throw new Error(`event sync: invalid ${name}`);
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed) || parsed < 0)
+        throw new Error(`event sync: invalid ${name}`);
+    return parsed;
+}
+function parseEvent(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error("event sync: invalid event");
+    const event = value;
+    if (typeof event.tenantId !== "string" ||
+        !Number.isSafeInteger(event.sequence) ||
+        (event.sequence ?? -1) < 0 ||
+        typeof event.eventId !== "string" ||
+        typeof event.type !== "string" ||
+        !Number.isSafeInteger(event.schemaVersion) ||
+        typeof event.recordedAt !== "string" ||
+        !("payload" in event))
+        throw new Error("event sync: invalid event");
+    return event;
+}
+async function readNdjson(response) {
+    if (!response.body)
+        return [];
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let pending = "";
+    const rows = [];
+    const consume = (line) => {
+        if (!line)
+            return;
+        if (new TextEncoder().encode(line).byteLength > MAX_EVENT_LINE_BYTES)
+            throw new Error("event sync: event line exceeds 1 MiB");
+        rows.push({ event: parseEvent(JSON.parse(line)), line });
+    };
+    for (;;) {
+        const { done, value } = await reader.read();
+        pending += decoder.decode(value, { stream: !done });
+        let newline = pending.indexOf("\n");
+        while (newline >= 0) {
+            consume(pending.slice(0, newline));
+            pending = pending.slice(newline + 1);
+            newline = pending.indexOf("\n");
+        }
+        if (pending.length > MAX_EVENT_LINE_BYTES)
+            throw new Error("event sync: event line exceeds 1 MiB");
+        if (done)
+            break;
+    }
+    if (pending)
+        consume(pending);
+    return rows;
+}
+function segmentName(date, index = 0) {
+    const day = date.toISOString().slice(0, 10);
+    return index === 0
+        ? `${day}.jsonl`
+        : `${day}-${String(index).padStart(3, "0")}.jsonl`;
+}
+async function writeJsonAtomic(path, value) {
+    const pid = globalThis.process?.pid ?? 0;
+    const temporary = `${path}.${pid}.tmp`;
+    await writeFile(temporary, JSON.stringify(value) + "\n", { mode: 0o600 });
+    await rename(temporary, path);
+}
+async function readCursor(path) {
+    try {
+        const value = JSON.parse(await readFile(path, "utf8"));
+        return typeof value.cursor === "number" &&
+            Number.isSafeInteger(value.cursor) &&
+            value.cursor >= 0
+            ? {
+                cursor: value.cursor,
+                floor: typeof value.floor === "number" &&
+                    Number.isSafeInteger(value.floor)
+                    ? value.floor
+                    : -1,
+            }
+            : null;
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return null;
+        throw error;
+    }
+}
+async function repairTail(directory) {
+    const segments = (await readdir(directory))
+        .filter((name) => SEGMENT_PATTERN.test(name))
+        .sort();
+    for (const name of segments.reverse()) {
+        const path = join(directory, name);
+        const bytes = await readFile(path);
+        if (bytes.length === 0)
+            continue;
+        const lastNewline = bytes.lastIndexOf(10);
+        if (lastNewline !== bytes.length - 1)
+            await truncate(path, lastNewline < 0 ? 0 : lastNewline + 1);
+        const complete = bytes
+            .subarray(0, lastNewline < 0 ? 0 : lastNewline)
+            .toString("utf8")
+            .trimEnd();
+        const line = complete.slice(complete.lastIndexOf("\n") + 1);
+        if (line)
+            return parseEvent(JSON.parse(line)).sequence;
+    }
+    return null;
+}
+async function retainBoundedSegments(directory, now, retainDays, maxBytes, current, floor) {
+    const segments = (await readdir(directory))
+        .filter((name) => SEGMENT_PATTERN.test(name))
+        .sort();
+    const sizes = new Map();
+    for (const name of segments)
+        sizes.set(name, (await stat(join(directory, name))).size);
+    let total = [...sizes.values()].reduce((sum, size) => sum + size, 0);
+    const cutoff = new Date(now);
+    cutoff.setUTCDate(cutoff.getUTCDate() - retainDays);
+    const remove = [];
+    for (const name of segments) {
+        if (name === current)
+            continue;
+        const expired = name.slice(0, 10) < cutoff.toISOString().slice(0, 10);
+        if (!expired && total <= maxBytes)
+            continue;
+        remove.push(name);
+        total -= sizes.get(name) ?? 0;
+    }
+    for (const name of remove) {
+        const body = await readFile(join(directory, name), "utf8");
+        const lines = body.trimEnd().split("\n");
+        const last = lines.at(-1);
+        if (last)
+            floor = Math.max(floor, parseEvent(JSON.parse(last)).sequence);
+    }
+    await Promise.all(remove.map((name) => rm(join(directory, name), { force: true })));
+    return floor;
+}
+async function appendBoundedRows(directory, date, rows, maxBytes) {
+    if (!Number.isSafeInteger(maxBytes) || maxBytes < MAX_EVENT_LINE_BYTES)
+        throw new Error("event sync: maxCacheBytes must be at least 1 MiB");
+    const day = date.toISOString().slice(0, 10);
+    const existing = (await readdir(directory))
+        .filter((name) => name.startsWith(day) && SEGMENT_PATTERN.test(name))
+        .sort();
+    let index = existing.length === 0 ? 0 : existing.length - 1;
+    let name = segmentName(date, index);
+    let size = 0;
+    try {
+        size = (await stat(join(directory, name))).size;
+    }
+    catch (error) {
+        if (error.code !== "ENOENT")
+            throw error;
+    }
+    let handle = await open(join(directory, name), "a", 0o600);
+    try {
+        for (const row of rows) {
+            const line = `${row.line}\n`;
+            const bytes = new TextEncoder().encode(line).byteLength;
+            if (size > 0 && size + bytes > maxBytes) {
+                await handle.sync();
+                await handle.close();
+                name = segmentName(date, ++index);
+                handle = await open(join(directory, name), "a", 0o600);
+                size = 0;
+            }
+            await handle.write(line);
+            size += bytes;
+        }
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+    return name;
+}
+function abortableSleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal.aborted) {
+            reject(signal.reason);
+            return;
+        }
+        const finish = () => {
+            signal.removeEventListener("abort", abort);
+            resolve();
+        };
+        const timer = setTimeout(finish, ms);
+        const abort = () => {
+            clearTimeout(timer);
+            signal.removeEventListener("abort", abort);
+            reject(signal.reason);
+        };
+        signal.addEventListener("abort", abort, { once: true });
+    });
+}
+export class CatalystEventSync {
+    options;
+    paths;
+    fetchImpl;
+    now;
+    sleeper;
+    lock = null;
+    controller = null;
+    running = null;
+    recoveredCursor = null;
+    floor = -1;
+    current = {
+        state: "stopped",
+        cursor: null,
+        head: null,
+        lastSyncAt: null,
+        error: null,
+    };
+    constructor(options) {
+        this.options = options;
+        this.paths = eventCachePaths(options.tenantId, options.directory);
+        this.fetchImpl = options.fetch ?? fetch;
+        this.now = options.now ?? (() => new Date());
+        this.sleeper = options.sleep ?? abortableSleep;
+    }
+    status() {
+        return { ...this.current };
+    }
+    async syncOnce(signal = new AbortController().signal) {
+        await mkdir(this.paths.directory, { recursive: true, mode: 0o700 });
+        if (!this.lock) {
+            this.lock = claimWriterLock(this.paths.lock, this.options.writerGuard ?? {});
+            this.recoveredCursor = await repairTail(this.paths.directory);
+        }
+        this.current = { ...this.current, state: "syncing", error: null };
+        const checkpoint = await readCursor(this.paths.cursor);
+        this.floor = Math.max(this.floor, checkpoint?.floor ?? -1);
+        let cursor = Math.max(checkpoint?.cursor ?? -1, this.recoveredCursor ?? -1, this.current.cursor ?? -1);
+        if (cursor < 0) {
+            cursor = await this.readCurrentHead(signal);
+            this.floor = cursor;
+        }
+        const result = await this.readPage(cursor, signal);
+        const now = this.now();
+        const maxCacheBytes = this.options.maxCacheBytes ?? DEFAULT_MAX_CACHE_BYTES;
+        let segment = segmentName(now);
+        if (result.rows.length > 0) {
+            segment = await appendBoundedRows(this.paths.directory, now, result.rows, maxCacheBytes);
+            cursor = result.rows[result.rows.length - 1].event.sequence;
+            this.recoveredCursor = cursor;
+        }
+        this.floor = await retainBoundedSegments(this.paths.directory, now, this.options.retainDays ?? DEFAULT_RETAIN_DAYS, maxCacheBytes, segment, this.floor);
+        await writeJsonAtomic(this.paths.cursor, {
+            version: 1,
+            cursor,
+            floor: this.floor,
+        });
+        this.current = {
+            state: "idle",
+            cursor,
+            head: result.head,
+            lastSyncAt: this.now().toISOString(),
+            error: null,
+        };
+        return { appended: result.rows.length, cursor, head: result.head };
+    }
+    start() {
+        if (this.running)
+            return this.running;
+        this.controller = new AbortController();
+        this.running = this.loop(this.controller.signal).finally(() => {
+            if (this.current.state !== "failed")
+                this.current = { ...this.current, state: "stopped" };
+            this.lock?.release();
+            this.lock = null;
+            this.recoveredCursor = null;
+            this.running = null;
+            this.controller = null;
+        });
+        return this.running;
+    }
+    async stop() {
+        const controller = this.controller;
+        if (!this.running) {
+            this.lock?.release();
+            this.lock = null;
+            this.current = { ...this.current, state: "stopped" };
+            return;
+        }
+        controller?.abort(new Error("event sync stopped"));
+        try {
+            await this.running;
+        }
+        catch (error) {
+            if (!controller?.signal.aborted)
+                throw error;
+        }
+    }
+    async loop(signal) {
+        let idle = this.options.idleMinMs ?? DEFAULT_IDLE_MIN_MS;
+        const maxIdle = this.options.idleMaxMs ?? DEFAULT_IDLE_MAX_MS;
+        try {
+            while (!signal.aborted) {
+                try {
+                    const result = await this.syncOnce(signal);
+                    idle =
+                        result.appended > 0
+                            ? (this.options.idleMinMs ?? DEFAULT_IDLE_MIN_MS)
+                            : Math.min(maxIdle, idle * 2);
+                }
+                catch (error) {
+                    if (error instanceof EventHistoryGapError ||
+                        (error instanceof EventSyncHttpError && error.status < 500))
+                        throw error;
+                    this.current = {
+                        ...this.current,
+                        state: "idle",
+                        error: error instanceof Error ? error.message : String(error),
+                    };
+                    idle = Math.min(maxIdle, idle * 2);
+                }
+                await this.sleeper(idle, signal);
+            }
+        }
+        catch (error) {
+            if (signal.aborted)
+                return;
+            this.current = {
+                ...this.current,
+                state: "failed",
+                error: error instanceof Error ? error.message : String(error),
+            };
+            throw error;
+        }
+    }
+    async request(since, signal) {
+        const timeout = AbortSignal.timeout(this.options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS);
+        const token = this.options.auth.kind === "token"
+            ? this.options.auth.token
+            : await this.options.auth.getToken();
+        return this.fetchImpl(`${this.options.baseUrl.replace(/\/$/, "")}/api/v1/events/backbone?since=${since}`, {
+            headers: { authorization: `Bearer ${token}` },
+            signal: AbortSignal.any([signal, timeout]),
+        });
+    }
+    async readCurrentHead(signal) {
+        const response = await this.request(Number.MAX_SAFE_INTEGER, signal);
+        if (response.status !== 409)
+            throw new EventSyncHttpError(response.status);
+        const body = (await response.json());
+        if (body.error !== "cursor_ahead_of_head")
+            throw new Error("event sync: head bootstrap contract mismatch");
+        return positiveInteger(body.resumeFrom, "bootstrap cursor");
+    }
+    async readPage(cursor, signal) {
+        const response = await this.request(cursor, signal);
+        if (!response.ok && response.status !== 409)
+            throw new EventSyncHttpError(response.status);
+        const head = positiveInteger(response.headers.get(HEAD_HEADER), "head header");
+        if (response.status === 409) {
+            const body = (await response.json());
+            throw new EventHistoryGapError("event sync: durable history has a gap", head, positiveInteger(body.resumeFrom, "resume cursor"), typeof body.reason === "string"
+                ? body.reason
+                : String(body.error ?? "cursor_refused"));
+        }
+        const rows = await readNdjson(response);
+        let previous = cursor;
+        for (const row of rows) {
+            if (row.event.tenantId !== this.options.tenantId)
+                throw new Error("event sync: tenant mismatch");
+            if (row.event.sequence <= previous)
+                throw new Error("event sync: non-monotonic sequence");
+            previous = row.event.sequence;
+        }
+        return { head, rows };
+    }
+}
+export async function readCachedEvents(options) {
+    const { directory } = eventCachePaths(options.tenantId, options.directory);
+    const checkpoint = await readCursor(eventCachePaths(options.tenantId, options.directory).cursor);
+    if (options.after !== undefined &&
+        checkpoint &&
+        options.after < checkpoint.floor)
+        throw new EventHistoryGapError("event cache: requested sequence precedes retained history", checkpoint.cursor, checkpoint.floor, "local-retention");
+    let names;
+    try {
+        names = (await readdir(directory))
+            .filter((name) => SEGMENT_PATTERN.test(name))
+            .sort();
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return [];
+        throw error;
+    }
+    const events = [];
+    for (const name of names) {
+        const body = await readFile(join(directory, name), "utf8");
+        const complete = body.endsWith("\n")
+            ? body.slice(0, -1)
+            : body.slice(0, body.lastIndexOf("\n") + 1);
+        for (const line of complete.split("\n")) {
+            if (!line)
+                continue;
+            const event = parseEvent(JSON.parse(line));
+            if (event.sequence > (options.after ?? -1))
+                events.push(event);
+        }
+    }
+    return events;
+}
+export async function* tailCachedEvents(options) {
+    const paths = eventCachePaths(options.tenantId, options.directory);
+    const { directory } = paths;
+    let cursor = options.after ?? (await readCursor(paths.cursor))?.cursor ?? -1;
+    const emit = async () => {
+        const rows = await readCachedEvents({ ...options, after: cursor });
+        if (rows.length > 0)
+            cursor = rows[rows.length - 1].sequence;
+        return rows;
+    };
+    const changes = watch(directory, { signal: options.signal })[Symbol.asyncIterator]();
+    const nextChange = () => changes.next().then((value) => ({ value }), (error) => ({ error }));
+    let pending = nextChange();
+    try {
+        for (const event of await emit())
+            yield event;
+        for (;;) {
+            const outcome = await pending;
+            if ("error" in outcome)
+                throw outcome.error;
+            const change = outcome.value;
+            if (change.done)
+                return;
+            pending = nextChange();
+            for (const event of await emit())
+                yield event;
+        }
+    }
+    finally {
+        await changes.return?.();
+        await pending;
+    }
+}
+export function eventIdentity(event) {
+    return JSON.stringify([event.tenantId, event.sequence, event.eventId]);
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

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

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { LiveSyncClient, AuthError, CLOSE_REAUTHENTICATE, buildConnectUrl, parseFrame, toWsOrigin, type AuthStrategy, type LiveSyncClientOptions, type LiveSyncStatus, type LogLevel, type WebSocketLike, type WebSocketFactory, } from "./live-sync-client.js";
-export { ENTITY_NAMES, CHANGE_OPS, PING_FRAME, PONG_FRAME, type AccountId, type EntityName, type ChangeOp, type ChangeFrame, type ResyncFrame, type SyncFrame, type PongFrame, type HeadFrame, type ServerFrame, } from "./types.js";
+export { ENTITY_NAMES, CHANGE_OPS, PING_FRAME, PONG_FRAME, type AccountId, type EntityName, type ChangeOp, type ChangeFrame, type ResyncFrame, type SyncFrame, type PongFrame, type HeadFrame, type SkipFrame, type ServerFrame, } from "./types.js";
 export { DEFAULT_SCOPE_NAME, CATALYST_ATTR, REPLICA_METRIC, REPLICA_LOG, REPLICA_SPAN, REPLICA_STATUS_CODE, type ReplicaApplyResult, type ReplicaGapEvent, type TelemetryConfig, } from "./otel.js";
 export { createTenantClient, memoryContractCache, normalizeBaseUrl, DEFAULT_TIMEOUT_MS, NEXT_CURSOR_HEADER, HEAD_SEQ_HEADER, TOTAL_HEADER, BLOCKED_ON_ASK_TOTAL_HEADER, CONTRACT_VERSION_HEADER, type TenantClient, type TenantClientOptions, type TenantClientFailure, type ContractCacheEntry, type ContractCacheStore, type ContractOptions, type ContractResult, type ContractFailure, pageCursor, type PageCursor, type KeysetPageMeta, type IssueListParams, type IssueListResult, type IssueGetResult, type PullListParams, type PullListResult, type PullGetResult, type ProjectListParams, type ProjectListResult, type MeResult, type AgentRouteName, type AgentCallFailure, type ProxiedWriteOutcome, type ProxiedWriteBody, type IssueStateInput, type IssueStateResult, type IssueLabelInput, type IssueLabelItemResult, type IssueLabelResult, type IssueCommentInput, type IssueCommentResult, type IssueCreateInput, type IssueCreateResult, type ReactionInput, type ReactionResult, type ProxiedAttachment, type AttachmentInput, type AttachmentResult, type AttachmentsResult, type SessionPlanEntry, type SessionActivity, type SessionInput, type EnsureSessionOutcome, type SessionResult, type AskInput, type AskResult, type AskAcceptInput, type AskAcceptRefusal, type AskAcceptResult, } from "./tenant-client.js";
 export { CONTRACT_ROUTE, TENANT_CONTRACT_KEYS, isTenantContract, readTenantContract, routeByName, teamByKey, teamForTicket, stageIdForSlot, labelIdFor, type TenantContract, type WorkflowSlot, type LabelScopeKind, type ContractLabel, type ContractStage, type ContractReadinessCheck, type ContractTeam, type ContractRoute, type ContractMergeRepository, type ContractMergeCleanPassShape, type ContractAdvanceRule, type TeamLookup, type StageLookup, type LabelLookup, } from "./tenant-contract.js";