@smart-data-engines/sde 0.1.0-dev.0

package/dist/cutover.js

@@ -0,0 +1,219 @@
+/** Validate a signed local cutover authorization without adopting a map or touching an engine. */
+import { createHash } from 'node:crypto';
+import { CanonicalError, canonicalBytes, compareCodePoints } from './canonical.js';
+import { MapError, MigrationRefused } from './errors.js';
+import { checkMapProject, GENERATIONS_SINCE, MAX_EPOCH } from './generation.js';
+import { fingerprintOf, loadMap, verifyMapSignature } from './placement.js';
+import { enumerateShapes, shapeId } from './shapes.js';
+import { VerificationRequest } from './verification.js';
+/** A move: the maintained copy that takes over is in another engine binding than the source. */
+export const CUTOVER_PROTOCOL = 1;
+/** A relayout: the copy that takes over is in the source's own engine binding, under fresh names. */
+export const CUTOVER_RELAYOUT_PROTOCOL = 2;
+const FIELDS = ['kind', 'protocol', 'plan_id', 'project_id', 'group', 'pause_budget_ms',
+    'query_impact_digest', 'verification', 'before', 'success', 'abort', 'signature'].sort(compareCodePoints);
+const provenance = new WeakMap();
+function record(value, name) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        throw new MigrationRefused(`cutover ${name} must be an object`);
+    }
+    return value;
+}
+function hex(value, width, name) {
+    if (typeof value !== 'string' || !new RegExp(`^[0-9a-f]{${width}}$`).test(value)) {
+        throw new MigrationRefused(`cutover ${name} must be ${width} lowercase hexadecimal digits`);
+    }
+    return value;
+}
+function positive(value, name) {
+    if (typeof value !== 'number' || !Number.isSafeInteger(value) || value < 1 || value > MAX_EPOCH) {
+        throw new MigrationRefused(`cutover ${name} must be a positive safe integer`);
+    }
+    return value;
+}
+function equal(left, right) {
+    return canonicalBytes(left).equals(canonicalBytes(right));
+}
+function signature(document) {
+    const value = record(document['signature'], 'signature');
+    const names = Object.keys(value).sort(compareCodePoints);
+    if (!equal(names, ['alg', 'value']) && !equal(names, ['alg', 'key_id', 'value'])) {
+        throw new MigrationRefused('cutover signatures have missing or unknown fields');
+    }
+    if (value['alg'] !== 'ed25519' || typeof value['value'] !== 'string') {
+        throw new MigrationRefused('cutover signatures must use ed25519 and canonical base64');
+    }
+    const decoded = Buffer.from(value['value'], 'base64');
+    if (decoded.length !== 64 || decoded.toString('base64') !== value['value']) {
+        throw new MigrationRefused('cutover signatures must use ed25519 and canonical base64');
+    }
+    if ('key_id' in value && typeof value['key_id'] !== 'string') {
+        throw new MigrationRefused('cutover signature key_id must be a string');
+    }
+}
+function except(value, keys) {
+    return Object.fromEntries(Object.entries(value).filter(([name]) => !keys.includes(name)));
+}
+export class CutoverPlan {
+    planId;
+    projectId;
+    group;
+    before;
+    success;
+    abort;
+    verification;
+    pauseBudgetMs;
+    queryImpactDigest;
+    verifiedWith;
+    constructor(planId, projectId, group, before, success, abort, verification, pauseBudgetMs, queryImpactDigest, verifiedWith) {
+        this.planId = planId;
+        this.projectId = projectId;
+        this.group = group;
+        this.before = before;
+        this.success = success;
+        this.abort = abort;
+        this.verification = verification;
+        this.pauseBudgetMs = pauseBudgetMs;
+        this.queryImpactDigest = queryImpactDigest;
+        this.verifiedWith = verifiedWith;
+        Object.freeze(this);
+    }
+    loaded() {
+        const saved = provenance.get(this);
+        if (saved === undefined)
+            throw new MigrationRefused('cutover execution requires an immutable loaded plan');
+        return saved;
+    }
+    get fingerprint() { return provenance.get(this)?.fingerprint; }
+    get sourceEpoch() { this.loaded(); return this.before.groups[this.group].writeEpoch; }
+    get maintenanceEpoch() { return this.sourceEpoch + 1; }
+    get activationEpoch() { return this.sourceEpoch + 2; }
+    asRecord() { return JSON.parse(this.loaded().document); }
+    candidatePayload(outcome) {
+        if (outcome !== 'success' && outcome !== 'abort')
+            throw new MigrationRefused('cutover outcome must be success or abort');
+        return canonicalBytes(this.asRecord()[outcome]);
+    }
+    checkCurrent(current) {
+        this.loaded();
+        checkMapProject(current, this.projectId);
+        if (!current.signed || fingerprintOf(current) !== fingerprintOf(this.before)) {
+            throw new MigrationRefused('cutover plan does not name the current placement map');
+        }
+    }
+}
+function load(raw, model, projectId, publicKey) {
+    const body = record(structuredClone(raw), 'plan');
+    if (!equal(Object.keys(body).sort(compareCodePoints), FIELDS)) {
+        throw new MigrationRefused('cutover plan has missing or unknown fields');
+    }
+    if (typeof body['protocol'] !== 'number' || ![CUTOVER_PROTOCOL, CUTOVER_RELAYOUT_PROTOCOL].includes(body['protocol'])) {
+        throw new MigrationRefused('unsupported cutover plan protocol');
+    }
+    const protocol = body['protocol'];
+    if (body['kind'] !== 'sde-cutover')
+        throw new MigrationRefused('unsupported cutover document kind');
+    const identity = hex(body['plan_id'], 32, 'plan_id'), local = hex(body['project_id'], 32, 'project_id');
+    if (local !== projectId)
+        throw new MigrationRefused('cutover plan belongs to another locally configured project');
+    const budget = positive(body['pause_budget_ms'], 'pause_budget_ms');
+    const approval = hex(body['query_impact_digest'], 64, 'query_impact_digest'), group = body['group'];
+    if (typeof group !== 'string' || group.length === 0)
+        throw new MigrationRefused('cutover group must be a nonempty string');
+    signature(body);
+    const verifiedWith = verifyMapSignature(body, publicKey);
+    const documents = Object.fromEntries(['before', 'success', 'abort'].map(name => [name, record(body[name], name)]));
+    const maps = {};
+    for (const name of ['before', 'success', 'abort']) {
+        const document = documents[name];
+        signature(document);
+        for (const value of Object.values(record(document['groups'], 'groups'))) {
+            const spot = record(value, 'group'), derived = spot['derived'] === undefined ? [] : spot['derived'];
+            if (!Array.isArray(derived))
+                throw new MigrationRefused('cutover derived copies must be an array');
+            for (const value of [spot['source'], ...derived]) {
+                const material = record(value, 'materialization'), layout = record(material['layout'], 'layout');
+                if (layout['auto'])
+                    throw new MigrationRefused('cutover maps require explicit physical layouts');
+            }
+        }
+        const parsed = loadMap(document, { model, publicKey, requireSignature: true });
+        // Generations arrived in contract 4 and contract 5 keeps them. The three candidates share every
+        // top-level attribute, contract included, which the comparison below enforces.
+        if (parsed.contract < GENERATIONS_SINCE) {
+            throw new MigrationRefused(`cutover protocol ${protocol} requires placement map contract ${GENERATIONS_SINCE} or later`);
+        }
+        checkMapProject(parsed, projectId);
+        positive(parsed.mapVersion, 'map_version');
+        maps[name] = parsed;
+    }
+    const before = maps['before'], success = maps['success'], abort = maps['abort'];
+    if (!(before.mapVersion < success.mapVersion && success.mapVersion < abort.mapVersion)) {
+        throw new MigrationRefused('cutover versions must increase from before to success to abort');
+    }
+    const request = VerificationRequest.fromRecord(body['verification']);
+    if (!request.requiresSignature)
+        throw new MigrationRefused('cutover verification must require the signed before map');
+    request.checkSession(before, projectId, group);
+    const spot = before.groups[group];
+    if (spot.derived.length !== 1 || spot.alsoWrite.length !== 1 || spot.alsoWrite[0].id !== spot.derived[0].id) {
+        throw new MigrationRefused('cutover requires exactly one derived copy maintained by fan-out');
+    }
+    const source = spot.source, target = spot.derived[0], epoch = spot.writeEpoch;
+    const same = source.engine === target.engine;
+    if (protocol === CUTOVER_PROTOCOL && same)
+        throw new MigrationRefused('cutover source and target must use different engine bindings');
+    if (protocol === CUTOVER_RELAYOUT_PROTOCOL && !same) {
+        throw new MigrationRefused("a relayout (cutover protocol 2) activates a copy in the source's own engine binding");
+    }
+    if (epoch > MAX_EPOCH - 2)
+        throw new MigrationRefused('cutover needs two available write generations');
+    const affected = new Set(enumerateShapes(model).filter(shape => shape.group === group).map(shapeId));
+    if ([...affected].some(shape => (before.routing[shape] ?? source.id) !== source.id)) {
+        throw new MigrationRefused('cutover before-map reads must still use the source');
+    }
+    const beforeRaw = documents['before'], beforeGroups = record(beforeRaw['groups'], 'groups');
+    const routes = Object.fromEntries(Object.entries(before.routing).filter(([shape]) => !affected.has(shape)));
+    const stableKeys = ['signature', 'map_version', 'groups', 'routing'];
+    const stable = except(beforeRaw, stableKeys);
+    for (const [name, material, terminalEpoch] of [['success', target, epoch + 2], ['abort', source, epoch + 1]]) {
+        const document = documents[name], parsed = maps[name], groups = record(document['groups'], 'groups');
+        if (!equal(except(document, stableKeys), stable) || !equal(Object.keys(parsed.groups).sort(compareCodePoints), Object.keys(before.groups).sort(compareCodePoints))) {
+            throw new MigrationRefused('cutover cannot change other map attributes or groups');
+        }
+        if (!equal(parsed.routing, routes))
+            throw new MigrationRefused('cutover terminal routing must preserve the unaffected groups');
+        for (const other of Object.keys(before.groups)) {
+            if (other !== group && !equal(groups[other], beforeGroups[other]))
+                throw new MigrationRefused('cutover cannot change an unaffected group');
+        }
+        const terminal = record(groups[group], 'terminal group');
+        if (!equal(Object.keys(terminal).sort(compareCodePoints), ['source', 'write_epoch']) || terminal['write_epoch'] !== terminalEpoch) {
+            throw new MigrationRefused('cutover terminal group must contain only its source and decision generation');
+        }
+        const candidate = record(terminal['source'], 'terminal source');
+        if (typeof candidate['id'] !== 'string' || candidate['id'].length === 0) {
+            throw new MigrationRefused('cutover terminal source must have a nonempty string id');
+        }
+        const originalGroup = record(beforeGroups[group], 'group');
+        const original = record(name === 'abort' ? originalGroup['source'] : originalGroup['derived'][0], 'materialization');
+        if (!equal(except(candidate, ['id']), except(original, ['id', 'lag_budget_ms'])) || parsed.groups[group].source.engine !== material.engine) {
+            throw new MigrationRefused('cutover terminal map changed the authorized physical materialization');
+        }
+    }
+    const plan = new CutoverPlan(identity, local, group, before, success, abort, request, budget, approval, verifiedWith);
+    provenance.set(plan, { document: canonicalBytes(body).toString('utf8'),
+        fingerprint: createHash('sha256').update(canonicalBytes(except(body, ['signature']))).digest('hex') });
+    return plan;
+}
+export function loadCutoverPlan(raw, options) {
+    try {
+        return load(raw, options.model, options.projectId, options.publicKey);
+    }
+    catch (error) {
+        if (error instanceof MapError || error instanceof CanonicalError)
+            throw new MigrationRefused(`cutover document refused: ${error.message}`);
+        throw error;
+    }
+}
+//# sourceMappingURL=cutover.js.map

package/dist/cutover.js.map

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

package/dist/demo/model.d.ts

@@ -0,0 +1,28 @@
+import { Timestamp } from '../timestamp.js';
+export declare function weatherModel(): import("../model.js").LogicalModel;
+export declare const baseTime: Timestamp;
+export declare const celsiusBaseCents = 1525, celsiusModulus = 1000;
+export declare const humidityBase = 30, humidityModulus = 70;
+export declare const generatorSpec: Readonly<{
+    kind: "sde-weather-generator";
+    version: 1;
+    worker: 0;
+    station_template: "weather-{run_id}-{worker}";
+    seed_template: "sde-weather-v1:{run_id}:{worker}:{sequence}";
+    base_time: string;
+    timestamp_step_microseconds: 1;
+    celsius_base_cents: 1525;
+    celsius_modulus: 1000;
+    humidity_base: 30;
+    humidity_modulus: 70;
+    id: "first 16 bytes of SHA256(UTF8(seed)), RFC4122 UUID version bits";
+    uuid_version: 4;
+}>;
+export declare const generatorId: string;
+export declare function reading(runId: string, worker: number, sequence: number): {
+    station: string;
+    at: Timestamp;
+    celsius: string;
+    humidity: bigint;
+    id: string;
+};

package/dist/demo/model.js

@@ -0,0 +1,40 @@
+/** The same fixed logical Weather model used by the Python customer starter. */
+import { createHash } from 'node:crypto';
+import { canonicalBytes } from '../canonical.js';
+import { assemble } from '../model.js';
+import { Timestamp } from '../timestamp.js';
+export function weatherModel() {
+    return assemble([{ name: 'WeatherReading', fields: [
+                { name: 'at', type: 'timestamptz', nullable: false },
+                { name: 'celsius', type: 'decimal(8,2)', nullable: false },
+                { name: 'humidity', type: 'int64', nullable: false },
+                { name: 'id', type: 'uuid', nullable: false },
+                { name: 'station', type: 'string', nullable: false },
+            ], key: ['station', 'at'], pii: [], residency: 'EU' }], [], [], { amount: '500.00', currency: 'EUR' });
+}
+export const baseTime = Timestamp.from('2026-01-01T00:00:00.000000Z');
+const stationTemplate = 'weather-{run_id}-{worker}', seedTemplate = 'sde-weather-v1:{run_id}:{worker}:{sequence}';
+export const celsiusBaseCents = 1525, celsiusModulus = 1000;
+export const humidityBase = 30, humidityModulus = 70;
+const uuidVersion = 4;
+export const generatorSpec = Object.freeze({
+    kind: 'sde-weather-generator', version: 1, worker: 0,
+    station_template: stationTemplate, seed_template: seedTemplate,
+    base_time: baseTime.toISOString(), timestamp_step_microseconds: 1,
+    celsius_base_cents: celsiusBaseCents, celsius_modulus: celsiusModulus,
+    humidity_base: humidityBase, humidity_modulus: humidityModulus,
+    id: 'first 16 bytes of SHA256(UTF8(seed)), RFC4122 UUID version bits', uuid_version: uuidVersion,
+});
+export const generatorId = 'weather-v1:' + createHash('sha256').update(canonicalBytes(generatorSpec)).digest('hex');
+export function reading(runId, worker, sequence) {
+    const bytes = createHash('sha256').update(seedTemplate.replace('{run_id}', runId).replace('{worker}', String(worker)).replace('{sequence}', String(sequence))).digest().subarray(0, 16);
+    bytes[6] = (bytes[6] & 0x0f) | (uuidVersion << 4);
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    const hex = bytes.toString('hex'), cents = celsiusBaseCents + sequence % celsiusModulus;
+    return { station: stationTemplate.replace('{run_id}', runId).replace('{worker}', String(worker)),
+        at: Timestamp.fromEpochMicroseconds(baseTime.epochMicroseconds + BigInt(sequence)),
+        celsius: `${Math.floor(cents / 100)}.${String(cents % 100).padStart(2, '0')}`,
+        humidity: BigInt(humidityBase + sequence % humidityModulus),
+        id: `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}` };
+}
+//# sourceMappingURL=model.js.map

package/dist/demo/model.js.map

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

package/dist/demo/project.d.ts

@@ -0,0 +1,19 @@
+export declare class DemoRefused extends Error {
+    constructor(message: string);
+}
+export declare function object(value: unknown): Record<string, unknown>;
+export declare function read(path: string, privateFile?: boolean): {
+    value: Record<string, unknown>;
+    payload: NonSharedBuffer;
+};
+export declare function write(path: string, value: unknown): void;
+export interface Binding {
+    dialect: 'postgres' | 'clickhouse';
+    dsn: string;
+}
+export declare function project(root: string): {
+    model: import("../model.js").LogicalModel;
+    bindings: Record<string, Binding>;
+    projectId: string;
+    activeMap: () => import("../placement.js").PlacementMap;
+};

package/dist/demo/project.js

@@ -0,0 +1,128 @@
+/** Runtime-only local configuration. This module never reads operator credentials. */
+import { createHash, randomUUID } from 'node:crypto';
+import { closeSync, existsSync, fsyncSync, lstatSync, mkdirSync, openSync, readFileSync, renameSync, unlinkSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { canonicalBytes, digest16 } from '../canonical.js';
+import { checkMapProject } from '../generation.js';
+import { loadMap } from '../placement.js';
+import { neutralDeclaration } from '../model.js';
+import { weatherModel } from './model.js';
+export class DemoRefused extends Error {
+    constructor(message) { super(message); this.name = 'DemoRefused'; }
+}
+export function object(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        throw new DemoRefused('Expected a local JSON object.');
+    return value;
+}
+export function read(path, privateFile = false) {
+    const stat = lstatSync(path);
+    if (!stat.isFile() || stat.size > 2 * 1024 * 1024 || (privateFile && (stat.mode & 0o777) !== 0o600)) {
+        throw new DemoRefused('A required local file is invalid; credential files need mode 0600.');
+    }
+    const payload = readFileSync(path);
+    if (payload.length > 2 * 1024 * 1024)
+        throw new DemoRefused('The local input exceeds 2 MiB.');
+    return { value: object(JSON.parse(payload.toString('utf8'))), payload };
+}
+function ensureDirectory(path) {
+    if (existsSync(path))
+        return;
+    const parent = dirname(path);
+    ensureDirectory(parent);
+    try {
+        mkdirSync(path, { mode: 0o700 });
+    }
+    catch (error) {
+        if (error.code !== 'EEXIST')
+            throw error;
+    }
+    const fd = openSync(parent, 'r');
+    try {
+        fsyncSync(fd);
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+export function write(path, value) {
+    const directory = dirname(path);
+    ensureDirectory(directory);
+    const temporary = join(directory, `.weather-${randomUUID()}.tmp`);
+    const fd = openSync(temporary, 'wx', 0o600);
+    try {
+        writeFileSync(fd, JSON.stringify(value) + '\n');
+        fsyncSync(fd);
+    }
+    finally {
+        closeSync(fd);
+    }
+    try {
+        renameSync(temporary, path);
+        const parent = openSync(directory, 'r');
+        try {
+            fsyncSync(parent);
+        }
+        finally {
+            closeSync(parent);
+        }
+    }
+    finally {
+        if (existsSync(temporary))
+            unlinkSync(temporary);
+    }
+}
+export function project(root) {
+    if (existsSync(join(root, 'reset-request.json')))
+        throw new DemoRefused('Reset was requested; set up a fresh directory.');
+    const config = read(join(root, 'config.json')).value;
+    const marker = read(join(root, 'setup-complete.json')).value;
+    if (Object.keys(config).sort().join(',') !== 'engines,model,project_id,protocol,public_keys' || config.protocol !== 1 ||
+        marker.protocol !== 1 || marker.config_digest !== digest16(config)) {
+        throw new DemoRefused('Setup is incomplete or config changed; restore the enrolled configuration.');
+    }
+    const model = weatherModel();
+    if (!canonicalBytes(object(config.model)).equals(canonicalBytes(neutralDeclaration(model)))) {
+        throw new DemoRefused('The starter requires the Weather model.');
+    }
+    const publicKey = Object.create(null);
+    for (const [name, value] of Object.entries(object(config.public_keys))) {
+        if (typeof value !== 'string' || !name)
+            throw new DemoRefused('Invalid trusted public key.');
+        const decoded = Buffer.from(value, 'base64');
+        if (decoded.length !== 32 || decoded.toString('base64') !== value)
+            throw new DemoRefused('Invalid Ed25519 key encoding.');
+        publicKey[name] = decoded;
+    }
+    if (!Object.keys(publicKey).length || typeof config.project_id !== 'string')
+        throw new DemoRefused('Missing project or trusted keys.');
+    const metadata = read(join(root, 'resources.json')).value;
+    const credentials = read(join(root, 'runtime-credentials.json'), true);
+    if (metadata.status !== 'ready' || object(metadata.credential_hashes).runtime !==
+        createHash('sha256').update(credentials.payload).digest('hex')) {
+        throw new DemoRefused('Runtime credentials differ from the ready resource allocation.');
+    }
+    const bindings = {};
+    const engines = object(config.engines);
+    if (Object.keys(engines).sort().join(',') !== Object.keys(credentials.value).sort().join(',')) {
+        throw new DemoRefused('Runtime credential bindings are incomplete.');
+    }
+    for (const [name, value] of Object.entries(engines)) {
+        const entry = object(value), dsn = credentials.value[name];
+        if (!/^[a-z][a-z0-9_-]{0,47}$/.test(name) || !['postgres', 'clickhouse'].includes(String(entry.dialect)) ||
+            typeof dsn !== 'string' || !dsn)
+            throw new DemoRefused('Invalid runtime engine binding.');
+        bindings[name] = { dialect: entry.dialect, dsn };
+    }
+    const projectId = config.project_id;
+    function activeMap() {
+        if (existsSync(join(root, 'reset-request.json')))
+            throw new DemoRefused('Reset was requested; the workload has stopped.');
+        const placement = loadMap(read(join(root, 'state', 'active-map.json')).value, { model, publicKey, requireSignature: true });
+        checkMapProject(placement, projectId);
+        return placement;
+    }
+    activeMap();
+    return { model, bindings, projectId, activeMap };
+}
+//# sourceMappingURL=project.js.map

package/dist/demo/project.js.map

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

package/dist/demo/weather.d.ts

@@ -0,0 +1,73 @@
+import type { Row } from '../session.js';
+/** What a run can drive. The CLI offers and the runtime accepts this one list. */
+export declare const workloads: readonly ["mixed", "point", "analytics", "fleet", "alerts"];
+export type Workload = typeof workloads[number];
+/**
+ * The alert threshold. Humidity is 30 + sequence % 70, so a reading alerts when sequence % 70 is 65
+ * or more - five readings in seventy, known exactly from the sequence number.
+ */
+export declare const alertHumidity = 95;
+export declare const alertPage = 100;
+export interface RunOptions {
+    iterations?: number;
+    batchSize?: number;
+    intervalMs?: number;
+    recoveryMs?: number;
+    workload?: Workload;
+}
+export interface RunReport {
+    protocol: 2;
+    generator_id: string;
+    run_id: string;
+    language: 'typescript';
+    status: 'running' | 'complete' | 'incomplete';
+    workload: string;
+    sdk_version: string;
+    sdk_module: string;
+    project_id: string;
+    model_version: string;
+    acknowledged_rows: number;
+    verified_after_uncertain_rows: number;
+    verified_rows: number;
+    pending: {
+        first: number;
+        count: number;
+    } | null;
+    map_versions: number[];
+    read_retries: number;
+    elapsed_ns?: string;
+    failure?: string;
+    cleanup_failed?: boolean;
+}
+/**
+ * Every earlier run of this project, by run ID, with the rows it verified.
+ *
+ * Fleet analytics reads every station's rows in one time window, and every run in a directory writes
+ * the same timeline, so the exact answer is a sum over the runs - known exactly, because generated
+ * values depend only on the sequence number and each run's local report says how many rows it
+ * verified. A run that did not complete makes that sum unknowable, so the workload refuses instead
+ * of comparing a read with a guess - except a run that failed before its first write, which wrote no
+ * row (failedBeforeWriting). The same rules as the Python starter's fleet_runs.
+ */
+export declare function fleetRuns(root: string, projectId: string): Map<string, number>;
+/**
+ * The first page, row count and celsius total of the window holding sequences 1..through. A page is
+ * in key order, station then time; a station is its run's namespace and is ASCII, so the default
+ * string order is the engines' byte order.
+ */
+export declare function fleetExpected(runs: Map<string, number>, through: number, limit: number): [Row[], number, string];
+/**
+ * The first page, count and celsius total of this run's alerts among sequences 1..through. One
+ * station, so key order - station, then time - is sequence order. With no alert yet the total is
+ * null, as the library reports a summary of no values on every engine. The same rules as the Python
+ * starter's alert_expected.
+ */
+export declare function alertExpected(runId: string, through: number, limit: number): [Row[], number, string | null];
+/**
+ * Refuse before a run's report exists when a binding's driver cannot be imported. Without this the
+ * first session open failed inside the run's retry loop: ten seconds of retries, a message that could
+ * only say the operation did not complete, and a report left `incomplete`. ClickHouse is spoken over
+ * fetch and needs no package. The import is the adapter's own, resolved from this package.
+ */
+export declare function requireDrivers(dialects: Iterable<string>, load?: (name: string) => Promise<unknown>): Promise<void>;
+export declare function runWeather(root: string, options?: RunOptions): Promise<RunReport>;