tubeless 0.1.0

package/dist/reporter.d.ts

@@ -0,0 +1,50 @@
+import type { PipelineHooks, PipelineLogger } from "./pipeline.js";
+export type ReporterColorMode = "always" | "auto" | "never";
+export type ReporterSymbolMode = "ascii" | "auto" | "emoji" | "unicode";
+export interface ReporterTerminalCapabilities {
+    color: boolean;
+    isTTY: boolean;
+    unicode: boolean;
+}
+export interface RunReporterConfig {
+    /** Defaults to auto: color only when the output supports it. */
+    color?: ReporterColorMode;
+    /** Defaults to auto: Unicode in capable terminals, ASCII elsewhere. */
+    symbols?: ReporterSymbolMode;
+    /** Override detected capabilities, primarily for custom streams and tests. */
+    terminal?: Partial<ReporterTerminalCapabilities>;
+    /** Log the pipeline start summary. Defaults to true. */
+    logPlan?: boolean;
+    /** Log the final pipeline summary. Defaults to true. */
+    logSummary?: boolean;
+}
+export interface RunReporterOptions extends RunReporterConfig {
+    log: PipelineLogger;
+}
+export interface ReporterSymbols {
+    complete: string;
+    fail: string;
+    pending: string;
+    skip: string;
+    start: string;
+}
+export declare function detectTerminalCapabilities(overrides?: Partial<ReporterTerminalCapabilities>): ReporterTerminalCapabilities;
+export declare function formatDurationMs(durationMs: number): string;
+export interface ReporterTheme {
+    capabilities: ReporterTerminalCapabilities;
+    colorEnabled: boolean;
+    styled: {
+        complete(value: string): string;
+        description(value: string): string;
+        duration(value: string): string;
+        fail(value: string): string;
+        pipeline(value: string): string;
+        skip(value: string): string;
+        start(value: string): string;
+    };
+    symbols: ReporterSymbols;
+}
+export declare function createReporterTheme(config?: RunReporterConfig): ReporterTheme;
+/** Create concise, append-only lifecycle logging for a pipeline run. */
+export declare function createRunReporter<TResult = unknown>(options: RunReporterOptions): PipelineHooks<TResult>;
+//# sourceMappingURL=reporter.d.ts.map

package/dist/reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../src/reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGnE,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAC5D,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAExE,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,uEAAuE;IACvE,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAC,4BAA4B,CAAC,CAAC;IACjD,wDAAwD;IACxD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wDAAwD;IACxD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,GAAG,EAAE,cAAc,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAmBD,wBAAgB,0BAA0B,CACxC,SAAS,GAAE,OAAO,CAAC,4BAA4B,CAAM,GACpD,4BAA4B,CAa9B;AAsBD,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAU3D;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,4BAA4B,CAAC;IAC3C,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE;QACN,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;QAChC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;QACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;QAChC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;QAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;QAChC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;QAC5B,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;KAC9B,CAAC;IACF,OAAO,EAAE,eAAe,CAAC;CAC1B;AAED,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,iBAAsB,GAAG,aAAa,CAkBjF;AAED,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,OAAO,GAAG,OAAO,EACjD,OAAO,EAAE,kBAAkB,GAC1B,aAAa,CAAC,OAAO,CAAC,CAyGxB"}

package/dist/reporter.js

@@ -0,0 +1,167 @@
+import { hasVisibleStepProgress } from "./progress.js";
+const SYMBOLS = {
+    ascii: { complete: "ok", fail: "fail", pending: ".", skip: "-", start: "->" },
+    // Distinct from pending (○): skipped work uses a yellow dash, not a green check.
+    unicode: { complete: "✓", fail: "✗", pending: "○", skip: "–", start: "→" },
+    emoji: { complete: "✅", fail: "❌", pending: "▫️", skip: "⏭️", start: "⏳" },
+};
+const ANSI = {
+    boldCyan: "\u001B[1;36m",
+    cyan: "\u001B[36m",
+    dim: "\u001B[2m",
+    green: "\u001B[32m",
+    red: "\u001B[31m",
+    reset: "\u001B[0m",
+    yellow: "\u001B[33m",
+};
+export function detectTerminalCapabilities(overrides = {}) {
+    const isTTY = overrides.isTTY ?? process.stdout.isTTY === true;
+    const termIsDumb = process.env.TERM === "dumb";
+    const forceColor = process.env.FORCE_COLOR;
+    const autoColor = forceColor !== undefined
+        ? forceColor !== "0"
+        : process.env.NO_COLOR === undefined && isTTY && !termIsDumb;
+    return {
+        isTTY,
+        color: overrides.color ?? autoColor,
+        unicode: overrides.unicode ?? (isTTY && !termIsDumb),
+    };
+}
+function resolveColorEnabled(mode, capabilities) {
+    if (mode === "always")
+        return true;
+    if (mode === "never")
+        return false;
+    return capabilities.color;
+}
+function resolveSymbols(mode, capabilities) {
+    return SYMBOLS[mode === "auto" ? (capabilities.unicode ? "unicode" : "ascii") : mode];
+}
+function paint(enabled, code, value) {
+    return enabled ? `${code}${value}${ANSI.reset}` : value;
+}
+export function formatDurationMs(durationMs) {
+    const ms = Math.max(0, Math.round(durationMs));
+    if (ms < 1000)
+        return `${ms}ms`;
+    if (ms < 60_000) {
+        const seconds = ms / 1000;
+        return Number.isInteger(seconds) ? `${seconds}s` : `${seconds.toFixed(1)}s`;
+    }
+    const minutes = Math.floor(ms / 60_000);
+    const seconds = Math.round((ms % 60_000) / 1000);
+    return seconds === 0 ? `${minutes}m` : `${minutes}m${seconds}s`;
+}
+export function createReporterTheme(config = {}) {
+    const capabilities = detectTerminalCapabilities(config.terminal);
+    const colorEnabled = resolveColorEnabled(config.color ?? "auto", capabilities);
+    const symbols = resolveSymbols(config.symbols ?? "auto", capabilities);
+    return {
+        capabilities,
+        colorEnabled,
+        symbols,
+        styled: {
+            complete: (value) => paint(colorEnabled, ANSI.green, value),
+            description: (value) => paint(colorEnabled, ANSI.dim, value),
+            duration: (value) => paint(colorEnabled, ANSI.dim, value),
+            fail: (value) => paint(colorEnabled, ANSI.red, value),
+            pipeline: (value) => paint(colorEnabled, ANSI.boldCyan, value),
+            skip: (value) => paint(colorEnabled, ANSI.yellow, value),
+            start: (value) => paint(colorEnabled, ANSI.cyan, value),
+        },
+    };
+}
+/** Create concise, append-only lifecycle logging for a pipeline run. */
+export function createRunReporter(options) {
+    const { log } = options;
+    const logPlan = options.logPlan !== false;
+    const logSummary = options.logSummary !== false;
+    const { styled, symbols } = createReporterTheme(options);
+    // Throttle progress lines so concurrent mapped children stay readable.
+    const lastProgressLogAt = new Map();
+    const lastProgressMessage = new Map();
+    const progressLogIntervalMs = 750;
+    const displayName = (step) => step.name ?? step.id;
+    const clearProgress = (stepId) => {
+        lastProgressLogAt.delete(stepId);
+        lastProgressMessage.delete(stepId);
+    };
+    return {
+        onPipelineStart: (plan) => {
+            if (!logPlan)
+                return;
+            log.log(styled.pipeline(`Pipeline ${plan.pipelineId}: starting (${plan.steps.length} steps, dryRun=${plan.dryRun})`));
+        },
+        onStepStart: ({ step }) => {
+            const description = step.description ? ` - ${styled.description(step.description)}` : "";
+            log.log(`  ${styled.start(symbols.start)} ${displayName(step)}${description}`);
+        },
+        onStepProgress: ({ progress, step }) => {
+            // Ignore empty/non-visible progress snapshots (no message, total, or work count).
+            if (!hasVisibleStepProgress(progress))
+                return;
+            const total = progress.total !== undefined && Number.isFinite(progress.total)
+                ? String(progress.total)
+                : "?";
+            const message = progress.message ? ` ${progress.message}` : "";
+            const line = `${progress.completed}/${total}${message}`;
+            const now = Date.now();
+            const previousAt = lastProgressLogAt.get(step.id) ?? Number.NEGATIVE_INFINITY;
+            const previousLine = lastProgressMessage.get(step.id);
+            const isCompletion = progress.total !== undefined &&
+                Number.isFinite(progress.total) &&
+                progress.completed >= progress.total;
+            if (!isCompletion && line === previousLine && now - previousAt < progressLogIntervalMs) {
+                return;
+            }
+            if (!isCompletion && now - previousAt < progressLogIntervalMs && previousLine !== undefined) {
+                return;
+            }
+            lastProgressLogAt.set(step.id, now);
+            lastProgressMessage.set(step.id, line);
+            log.log(`  ${styled.description("…")} ${displayName(step)} ${styled.description(line)}`);
+        },
+        onStepComplete: (event) => {
+            clearProgress(event.id);
+            const durationMs = event.finishedAtMs - event.startedAtMs;
+            log.log(`  ${styled.complete(symbols.complete)} ${displayName(event)} ${styled.duration(`(${formatDurationMs(durationMs)})`)}`);
+        },
+        onStepSkip: (event) => {
+            clearProgress(event.id);
+            const detail = event.dependencyId
+                ? `${event.reason}: ${event.dependencyId}`
+                : (event.message ?? event.reason);
+            log.log(`  ${styled.skip(symbols.skip)} ${displayName(event.step)} ${styled.duration(`(${detail})`)}`);
+        },
+        onStepCancel: (event) => {
+            clearProgress(event.id);
+            log.warn(`  ${styled.skip(symbols.skip)} ${displayName(event.step)}: cancelled: ${event.error.message}`);
+        },
+        onStepFail: (event) => {
+            clearProgress(event.id);
+            log.error(`  ${styled.fail(symbols.fail)} ${displayName(event.step)}: ${event.error.message}`);
+        },
+        onFinalizeStart: () => {
+            log.log(`  ${styled.start(symbols.start)} finalize`);
+        },
+        onFinalizeComplete: ({ durationMs }) => {
+            log.log(`  ${styled.complete(symbols.complete)} finalize ${styled.duration(`(${formatDurationMs(durationMs)})`)}`);
+        },
+        onFinalizeError: ({ error }) => {
+            log.error(`  ${styled.fail(symbols.fail)} finalize: ${error.message}`);
+        },
+        onPipelineComplete: (result) => {
+            if (!logSummary)
+                return;
+            const durationMs = result.finishedAtMs - result.startedAtMs;
+            const message = `Pipeline ${result.pipelineId}: done in ${formatDurationMs(durationMs)} (status=${result.status}, steps=${result.steps.length}, errors=${result.errors.length})`;
+            if (result.status === "completed") {
+                log.log(styled.complete(message));
+            }
+            else {
+                log.error(styled.fail(message));
+            }
+        },
+    };
+}
+//# sourceMappingURL=reporter.js.map

package/dist/reporter.js.map

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

package/dist/retry.d.ts

@@ -0,0 +1,28 @@
+export interface RetryOptions {
+    maxAttempts: number;
+    baseDelayMs: number;
+    maxDelayMs?: number;
+    jitter?: boolean;
+    random?: () => number;
+    signal?: AbortSignal;
+    sleep?: (durationMs: number, signal?: AbortSignal) => Promise<void>;
+    /**
+     * Return false to stop retrying and rethrow the current error immediately.
+     * The attempt number is the 1-based attempt that just failed. When omitted,
+     * every error remains retryable until maxAttempts is reached.
+     */
+    shouldRetry?: (error: unknown, attempt: number) => boolean;
+}
+/** Metadata supplied to each retry operation attempt. */
+export interface RetryAttemptContext {
+    /** 1-based attempt number. */
+    attempt: number;
+    /** Total allowed attempts from `RetryOptions.maxAttempts`. */
+    maxAttempts: number;
+    /** The same signal used for backoff and pre-attempt cancellation checks. */
+    signal?: AbortSignal;
+}
+/** A no-argument async function remains assignable for simple retry callers. */
+export type RetryOperation<T> = (context: RetryAttemptContext) => Promise<T>;
+export declare function withRetry<T>(operation: RetryOperation<T>, options: RetryOptions, onRetry?: (attempt: number, error: unknown, delayMs: number) => void): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5D;AAED,yDAAyD;AACzD,MAAM,WAAW,mBAAmB;IAClC,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,gFAAgF;AAChF,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AA0B7E,wBAAsB,SAAS,CAAC,CAAC,EAC/B,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,EAC5B,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,GACnE,OAAO,CAAC,CAAC,CAAC,CAuCZ"}

package/dist/retry.js

@@ -0,0 +1,59 @@
+import { abortableSleep, throwIfAborted as throwIfSignalAborted } from "./abort.js";
+function computeDelayMs(attempt, options) {
+    const raw = options.baseDelayMs * 2 ** (attempt - 1);
+    const capped = options.maxDelayMs === undefined ? raw : Math.min(raw, options.maxDelayMs);
+    if (!options.jitter) {
+        return capped;
+    }
+    const jittered = capped + (options.random ?? Math.random)() * capped * 0.1;
+    return options.maxDelayMs === undefined ? jittered : Math.min(jittered, options.maxDelayMs);
+}
+function throwIfAborted(signal) {
+    throwIfSignalAborted(signal, "Retry");
+}
+async function sleepBeforeRetry(durationMs, options) {
+    throwIfAborted(options.signal);
+    if (options.sleep) {
+        await options.sleep(durationMs, options.signal);
+        throwIfAborted(options.signal);
+        return;
+    }
+    await abortableSleep(durationMs, options.signal, "Retry");
+}
+export async function withRetry(operation, options, onRetry) {
+    if (!Number.isInteger(options.maxAttempts) || options.maxAttempts < 1) {
+        throw new Error(`maxAttempts must be a positive integer, got ${options.maxAttempts}`);
+    }
+    if (!Number.isFinite(options.baseDelayMs) || options.baseDelayMs < 0) {
+        throw new Error(`baseDelayMs must be a non-negative finite number, got ${options.baseDelayMs}`);
+    }
+    if (options.maxDelayMs !== undefined &&
+        (!Number.isFinite(options.maxDelayMs) || options.maxDelayMs < 0)) {
+        throw new Error(`maxDelayMs must be a non-negative finite number, got ${options.maxDelayMs}`);
+    }
+    let lastError;
+    for (let attempt = 1; attempt <= options.maxAttempts; attempt++) {
+        throwIfAborted(options.signal);
+        try {
+            return await operation({
+                attempt,
+                maxAttempts: options.maxAttempts,
+                signal: options.signal,
+            });
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt >= options.maxAttempts) {
+                break;
+            }
+            if (options.shouldRetry && !options.shouldRetry(error, attempt)) {
+                throw error;
+            }
+            const delayMs = computeDelayMs(attempt, options);
+            onRetry?.(attempt, error, delayMs);
+            await sleepBeforeRetry(delayMs, options);
+        }
+    }
+    throw lastError;
+}
+//# sourceMappingURL=retry.js.map

package/dist/retry.js.map

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

package/dist/run-store-sqlite.d.ts

@@ -0,0 +1,12 @@
+import type { PipelineRunEventStore } from "./run-store.js";
+/** SQLite event store plus the explicit all-history maintenance operation. */
+export interface SqlitePipelineRunStore extends PipelineRunEventStore {
+    /** Delete every recorded event and compact the database; individual mutation stays forbidden. */
+    clearHistory(): void | Promise<void>;
+}
+/**
+ * Open the optional local SQLite trace store used by `tubeless run --store` and
+ * `tubeless ui`. The main executor never imports this module.
+ */
+export declare function openSqlitePipelineRunStore(filename: string): Promise<SqlitePipelineRunStore>;
+//# sourceMappingURL=run-store-sqlite.d.ts.map

package/dist/run-store-sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-store-sqlite.d.ts","sourceRoot":"","sources":["../src/run-store-sqlite.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,qBAAqB,EAEtB,MAAM,gBAAgB,CAAC;AAkFxB,8EAA8E;AAC9E,MAAM,WAAW,sBAAuB,SAAQ,qBAAqB;IACnE,iGAAiG;IACjG,YAAY,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AA+CD;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,sBAAsB,CAAC,CAwGjC"}

package/dist/run-store-sqlite.js

@@ -0,0 +1,187 @@
+import { mkdir } from "node:fs/promises";
+import * as path from "node:path";
+const RUN_EVENT_STORE_VERSION = 1;
+const RUN_EVENT_STORE_APPEND_ONLY_TRIGGERS = `
+  CREATE TRIGGER IF NOT EXISTS pipeline_run_events_no_update
+  BEFORE UPDATE ON pipeline_run_events
+  BEGIN
+    SELECT RAISE(ABORT, 'pipeline_run_events is append-only');
+  END;
+
+  CREATE TRIGGER IF NOT EXISTS pipeline_run_events_no_delete
+  BEFORE DELETE ON pipeline_run_events
+  BEGIN
+    SELECT RAISE(ABORT, 'pipeline_run_events is append-only');
+  END;
+`;
+const RUN_EVENT_STORE_SCHEMA = `
+  PRAGMA journal_mode = WAL;
+  PRAGMA synchronous = NORMAL;
+  PRAGMA foreign_keys = ON;
+
+  CREATE TABLE IF NOT EXISTS pipeline_run_events (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    version INTEGER NOT NULL,
+    run_id TEXT NOT NULL,
+    parent_run_id TEXT,
+    pipeline_id TEXT NOT NULL,
+    step_id TEXT,
+    attempt_id TEXT,
+    item_key TEXT,
+    event_name TEXT NOT NULL,
+    timestamp_ms INTEGER NOT NULL,
+    duration_ms REAL,
+    attributes_json TEXT NOT NULL,
+    error_json TEXT
+  );
+
+  CREATE INDEX IF NOT EXISTS pipeline_run_events_run_id_idx
+    ON pipeline_run_events(run_id, id);
+  CREATE INDEX IF NOT EXISTS pipeline_run_events_pipeline_id_idx
+    ON pipeline_run_events(pipeline_id, id DESC);
+  CREATE INDEX IF NOT EXISTS pipeline_run_events_timestamp_idx
+    ON pipeline_run_events(timestamp_ms DESC);
+
+  ${RUN_EVENT_STORE_APPEND_ONLY_TRIGGERS}
+`;
+function statement(database, sql) {
+    const prepared = database.query?.(sql) ?? database.prepare?.(sql);
+    if (!prepared)
+        throw new Error("The current SQLite runtime does not support prepared queries.");
+    return prepared;
+}
+async function loadSqliteModule() {
+    const specifier = "Bun" in globalThis ? "bun:sqlite" : "node:sqlite";
+    // SAFETY: The dynamic import resolves to the built-in sqlite module whose
+    // runtime shape is the `SqliteModule` interface we depend on.
+    return (await import(specifier));
+}
+async function openDatabase(filename) {
+    const module = await loadSqliteModule();
+    const Database = module.Database ?? module.DatabaseSync;
+    if (!Database)
+        throw new Error("No synchronous SQLite database implementation is available.");
+    return new Database(filename);
+}
+function mapRow(row) {
+    const event = {
+        // SAFETY: attributes_json was written by this store via JSON.stringify of a
+        // PipelineTraceEvent["attributes"] value, so parsing yields the same shape.
+        attributes: JSON.parse(row.attributes_json),
+        id: Number(row.id),
+        name: row.event_name,
+        pipelineId: row.pipeline_id,
+        runId: row.run_id,
+        timestampMs: Number(row.timestamp_ms),
+        version: row.version,
+    };
+    if (row.attempt_id)
+        event.attemptId = row.attempt_id;
+    if (row.duration_ms !== null)
+        event.durationMs = Number(row.duration_ms);
+    if (row.error_json) {
+        // SAFETY: error_json was written by this store via JSON.stringify of a
+        // NonNullable<PipelineTraceEvent["error"]> value, so parsing yields the same shape.
+        event.error = JSON.parse(row.error_json);
+    }
+    if (row.item_key)
+        event.itemKey = row.item_key;
+    if (row.parent_run_id)
+        event.parentRunId = row.parent_run_id;
+    if (row.step_id)
+        event.stepId = row.step_id;
+    return event;
+}
+/**
+ * Open the optional local SQLite trace store used by `tubeless run --store` and
+ * `tubeless ui`. The main executor never imports this module.
+ */
+export async function openSqlitePipelineRunStore(filename) {
+    const resolvedFilename = filename === ":memory:" ? filename : path.resolve(filename);
+    if (resolvedFilename !== ":memory:") {
+        await mkdir(path.dirname(resolvedFilename), { recursive: true });
+    }
+    const database = await openDatabase(resolvedFilename);
+    try {
+        // SAFETY: `PRAGMA user_version` always returns a single row with a
+        // `user_version` column, so the first result row matches this shape.
+        const versionRow = statement(database, "PRAGMA user_version").all()[0];
+        const version = Number(versionRow?.user_version ?? 0);
+        if (version !== 0 && version !== RUN_EVENT_STORE_VERSION) {
+            throw new Error(`Unsupported pipeline run store schema version ${version}; expected ${RUN_EVENT_STORE_VERSION}.`);
+        }
+        database.exec(RUN_EVENT_STORE_SCHEMA);
+        database.exec(`PRAGMA user_version = ${RUN_EVENT_STORE_VERSION}`);
+    }
+    catch (error) {
+        database.close();
+        throw error;
+    }
+    const insert = statement(database, `INSERT INTO pipeline_run_events (
+      version, run_id, parent_run_id, pipeline_id, step_id, attempt_id, item_key,
+      event_name, timestamp_ms, duration_ms, attributes_json, error_json
+    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`);
+    let closed = false;
+    return {
+        export(event) {
+            if (closed)
+                throw new Error("Cannot append to a closed pipeline run store.");
+            insert.run(event.version, event.runId, event.parentRunId ?? null, event.pipelineId, event.stepId ?? null, event.attemptId ?? null, event.itemKey ?? null, event.name, event.timestampMs, event.durationMs ?? null, JSON.stringify(event.attributes), event.error ? JSON.stringify(event.error) : null);
+        },
+        flush() { },
+        async listEvents(query = {}) {
+            if (closed)
+                throw new Error("Cannot query a closed pipeline run store.");
+            const predicates = [];
+            const params = [];
+            if (query.afterId !== undefined) {
+                predicates.push("id > ?");
+                params.push(query.afterId);
+            }
+            if (query.pipelineId !== undefined) {
+                predicates.push("pipeline_id = ?");
+                params.push(query.pipelineId);
+            }
+            if (query.runId !== undefined) {
+                predicates.push("run_id = ?");
+                params.push(query.runId);
+            }
+            const limit = Math.max(1, Math.min(100_000, Math.floor(query.limit ?? 20_000)));
+            params.push(limit);
+            const where = predicates.length > 0 ? `WHERE ${predicates.join(" AND ")}` : "";
+            // SAFETY: The SELECT * columns match the StoredEventRow interface exactly
+            // (the table schema is owned by this module), so each result row is one.
+            const rows = statement(database, `SELECT * FROM pipeline_run_events ${where} ORDER BY id ASC LIMIT ?`).all(...params);
+            return rows.map(mapRow);
+        },
+        clearHistory() {
+            if (closed)
+                throw new Error("Cannot clear a closed pipeline run store.");
+            try {
+                database.exec(`
+          BEGIN IMMEDIATE;
+          DROP TRIGGER IF EXISTS pipeline_run_events_no_update;
+          DROP TRIGGER IF EXISTS pipeline_run_events_no_delete;
+          DELETE FROM pipeline_run_events;
+          ${RUN_EVENT_STORE_APPEND_ONLY_TRIGGERS}
+          COMMIT;
+        `);
+            }
+            catch (error) {
+                try {
+                    database.exec("ROLLBACK");
+                }
+                catch { }
+                throw error;
+            }
+            database.exec("VACUUM; PRAGMA wal_checkpoint(TRUNCATE);");
+        },
+        close() {
+            if (closed)
+                return;
+            closed = true;
+            database.close();
+        },
+    };
+}
+//# sourceMappingURL=run-store-sqlite.js.map

package/dist/run-store-sqlite.js.map

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

package/dist/run-store-ui-http.d.ts

@@ -0,0 +1,5 @@
+/** Format a host literal for an HTTP URL or authority. */
+export declare function formatHttpUrlHost(host: string): string;
+/** Normalize a bare HTTP authority, including omission of the default port. */
+export declare function normalizeHttpAuthority(authority: string | undefined): string | undefined;
+//# sourceMappingURL=run-store-ui-http.d.ts.map

package/dist/run-store-ui-http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-store-ui-http.d.ts","sourceRoot":"","sources":["../src/run-store-ui-http.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,+EAA+E;AAC/E,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CASxF"}

package/dist/run-store-ui-http.js

@@ -0,0 +1,19 @@
+/** Format a host literal for an HTTP URL or authority. */
+export function formatHttpUrlHost(host) {
+    return host.includes(":") ? `[${host}]` : host;
+}
+/** Normalize a bare HTTP authority, including omission of the default port. */
+export function normalizeHttpAuthority(authority) {
+    if (!authority || /[\s\\/@?#]/.test(authority))
+        return undefined;
+    try {
+        const parsed = new URL(`http://${authority}/`);
+        if (parsed.username || parsed.password || parsed.pathname !== "/")
+            return undefined;
+        return parsed.host.toLowerCase();
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=run-store-ui-http.js.map

package/dist/run-store-ui-http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-store-ui-http.js","sourceRoot":"","sources":["../src/run-store-ui-http.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACjD,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,sBAAsB,CAAC,SAA6B;IAClE,IAAI,CAAC,SAAS,IAAI,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IACjE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,UAAU,SAAS,GAAG,CAAC,CAAC;QAC/C,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,KAAK,GAAG;YAAE,OAAO,SAAS,CAAC;QACpF,OAAO,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/run-store-ui-page.d.ts

@@ -0,0 +1,2 @@
+export declare const PIPELINE_RUN_STUDIO_HTML: string;
+//# sourceMappingURL=run-store-ui-page.d.ts.map

package/dist/run-store-ui-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-store-ui-page.d.ts","sourceRoot":"","sources":["../src/run-store-ui-page.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,QAqvB7B,CAAC"}