@vibesdotdev/runnable 0.0.0-stage → 1.0.0-rc.0

package/dist/client/tracking/projection.js

@@ -0,0 +1,100 @@
+import { RawArtifactRowsSchema, RawLogRowsSchema, RawMetricRowsSchema, RawRunSchema } from "../../schemas/projection.js";
+import * as z from "zod/v4";
+import { CapabilityError, settle } from "@vibesdotdev/kernel";
+import { serviceOrigin } from "@vibesdotdev/infra-contracts/service";
+export * from "../../schemas/projection.js";
+async function deriveBaseUrl(runtime) {
+    return serviceOrigin(runtime, 'runnable');
+}
+/**
+ * The refusal for any malformed response. It carries no cause: the JSON parse
+ * or body-read failure's message can quote the payload itself, so the refusal
+ * stays value-free by construction — only the endpoint is named.
+ */
+function invalidResponse(endpoint) {
+    return new CapabilityError('Runnable host returned an invalid response.', 'UNAVAILABLE', {
+        reason: 'runnable-projection-response-invalid',
+        retryable: false,
+        details: { endpoint }
+    });
+}
+async function readPayload(response, schema, endpoint) {
+    const read = await settle(() => response.json());
+    if (!read.ok)
+        throw invalidResponse(endpoint);
+    const parsed = schema.safeParse(read.value);
+    if (!parsed.success)
+        throw invalidResponse(endpoint);
+    return parsed.data;
+}
+function requestFailure(endpoint, response) {
+    return new CapabilityError('Runnable host request failed.', 'UNAVAILABLE', {
+        reason: 'runnable-projection-request-failed',
+        retryable: response.status >= 500,
+        details: { endpoint, status: response.status }
+    });
+}
+export class BaseRunProjectionClient {
+    runtime;
+    baseUrl = null;
+    constructor(runtime) {
+        this.runtime = runtime;
+    }
+    /** Pin the runnable-web origin for in-process consumers (e.g. SSR routes). */
+    setBaseUrl(url) {
+        this.baseUrl = url.replace(/\/+$/, '');
+    }
+    /** The pinned origin, else the selected runnable service target. */
+    async resolveBaseUrl() {
+        if (!this.baseUrl)
+            this.baseUrl = (await deriveBaseUrl(this.runtime)).replace(/\/+$/, '');
+        return this.baseUrl;
+    }
+    async fetchSnapshot(runId, options = {}) {
+        const reads = await this.fetchReads(runId, options);
+        if (!reads)
+            return null;
+        return this.project(reads);
+    }
+    async fetchReads(runId, options = {}) {
+        const fetcher = options.fetch ?? fetch;
+        const base = await this.resolveBaseUrl();
+        const id = encodeURIComponent(runId);
+        const runEndpoint = '/api/runs/' + id;
+        const runResponse = await fetcher(base + runEndpoint);
+        if (!runResponse.ok) {
+            if (runResponse.status === 404) {
+                await runResponse.body?.cancel();
+                return null;
+            }
+            await runResponse.body?.cancel();
+            throw requestFailure(runEndpoint, runResponse);
+        }
+        const run = await readPayload(runResponse, RawRunSchema, runEndpoint);
+        const metricEndpoint = runEndpoint + '/metrics' +
+            (options.metricKey ? '?key=' + encodeURIComponent(options.metricKey) : '');
+        const logsEndpoint = runEndpoint + '/logs';
+        const artifactEndpoint = runEndpoint + '/artifacts' +
+            (options.artifactKind ? '?kind=' + encodeURIComponent(options.artifactKind) : '');
+        const [metricResponse, logsResponse, artifactResponse] = await Promise.all([
+            fetcher(base + metricEndpoint),
+            fetcher(base + logsEndpoint),
+            fetcher(base + artifactEndpoint)
+        ]);
+        const responses = [metricResponse, logsResponse, artifactResponse];
+        const endpoints = [metricEndpoint, logsEndpoint, artifactEndpoint];
+        const failedIndex = responses.findIndex((response) => !response.ok);
+        if (failedIndex >= 0) {
+            await Promise.allSettled(responses.map((response) => response.body?.cancel()));
+            throw requestFailure(endpoints[failedIndex], responses[failedIndex]);
+        }
+        const [metrics, logs, artifacts] = await Promise.all([
+            readPayload(metricResponse, RawMetricRowsSchema, metricEndpoint),
+            readPayload(logsResponse, RawLogRowsSchema, logsEndpoint),
+            readPayload(artifactResponse, RawArtifactRowsSchema, artifactEndpoint)
+        ]);
+        return { run, metrics, logs, artifacts };
+    }
+}
+export {} from "../../schemas/projection.js";
+//# sourceMappingURL=projection.js.map

package/dist/client/tracking/projection.js.map

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

package/dist/client/tracking/watch.d.ts

@@ -0,0 +1,10 @@
+import type { JsonValue } from '@vibesdotdev/kernel/schemas/json';
+import type { RunnableWatchPort } from "../../schemas/contracts/watch.ts";
+import { type RuntimeRef } from "@vibesdotdev/kernel";
+/** Subscribe before reading. Invalidations during a read stay one pending refresh, and a full replacement never overwrites a newer delivery. */
+export declare function watchRunnableSnapshots<Snapshot extends JsonValue>(runtime: RuntimeRef, port: RunnableWatchPort<Snapshot>, listener: (snapshot: {
+    runs: Snapshot[];
+    revision: number;
+}) => void | Promise<void>, signal: AbortSignal): Promise<() => Promise<void>>;
+export { type RunnableWatchPort } from '../../schemas/contracts/watch.ts';
+//# sourceMappingURL=watch.d.ts.map

package/dist/client/tracking/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../../src/client/tracking/watch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAgD,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGpG,gJAAgJ;AAChJ,wBAAsB,sBAAsB,CAAC,QAAQ,SAAS,SAAS,EACtE,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,iBAAiB,CAAC,QAAQ,CAAC,EACjC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EACpF,MAAM,EAAE,WAAW,GACjB,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CA4G9B;AAED,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/client/tracking/watch.js

@@ -0,0 +1,128 @@
+import { CapabilityError, CaughtFailureSchema, settle } from "@vibesdotdev/kernel";
+import { canonical } from "../records/identity.js";
+/** Subscribe before reading. Invalidations during a read stay one pending refresh, and a full replacement never overwrites a newer delivery. */
+export async function watchRunnableSnapshots(runtime, port, listener, signal) {
+    signal.throwIfAborted();
+    const invocation = runtime.captureInvocation();
+    const completion = Promise.withResolvers();
+    const subscriptionReady = Promise.withResolvers();
+    // Admission happens before a potentially late asynchronous subscription. Disposal
+    // must retain that resource until it arrives and its unsubscribe has settled.
+    void runtime.lifecycle.own(() => completion.promise);
+    let unsubscribe;
+    let pending = Promise.resolve();
+    let closed = false;
+    let opening = true;
+    let scheduled = false;
+    let dirty = false;
+    let revision = 0;
+    let previous;
+    let closing;
+    const failed = async (cause) => {
+        const failure = CaughtFailureSchema.parse(cause);
+        const delivered = await settle(() => port.failed(failure));
+        if (!delivered.ok)
+            runtime.diagnostics.error('Watch failure delivery failed', {
+                scope: 'runnable:watch', plugin: 'runnable', error: new AggregateError([cause, delivered.cause], 'Watch and failure delivery failed.', { cause })
+            });
+    };
+    const close = () => {
+        if (closing)
+            return closing;
+        closed = true;
+        signal.removeEventListener('abort', onAbort);
+        closing = (async () => {
+            const cleanup = await settle(async () => {
+                await subscriptionReady.promise;
+                await unsubscribe?.();
+            });
+            // A callback may itself unsubscribe. It must not await its own delivery;
+            // lifecycle ownership separately joins all deliveries and retains cleanup refusal.
+            void pending.then(() => {
+                if (cleanup.ok)
+                    completion.resolve();
+                else
+                    completion.reject(cleanup.cause);
+            }, completion.reject);
+            if (!cleanup.ok)
+                throw cleanup.cause;
+        })();
+        return closing;
+    };
+    const onAbort = () => {
+        void settle(close).then(async (result) => {
+            if (!result.ok)
+                await failed(result.cause);
+        });
+    };
+    signal.addEventListener('abort', onAbort, { once: true });
+    const enqueue = (initial) => {
+        // A burst while this read is scheduled must not append another read.
+        // The settled read chains one refresh when any of those invalidations arrived.
+        if (scheduled) {
+            dirty = true;
+            return pending;
+        }
+        scheduled = true;
+        const task = pending.then(() => invocation.run(async () => {
+            if (closed)
+                return;
+            dirty = false;
+            const runs = await port.read();
+            if (closed)
+                return;
+            const identity = canonical(runs);
+            if (previous === identity)
+                return;
+            await listener({ runs, revision: ++revision });
+            previous = identity;
+        }));
+        // Catch on this chain. A floating `finally` would reject again after a refused delivery.
+        pending = task.then(() => {
+            scheduled = false;
+            if (!initial && dirty && !closed)
+                void enqueue(false);
+        }, async (cause) => {
+            scheduled = false;
+            if (!initial)
+                await failed(cause);
+            if (!initial && dirty && !closed)
+                void enqueue(false);
+        });
+        return task;
+    };
+    try {
+        try {
+            signal.throwIfAborted();
+            unsubscribe = await port.subscribe(() => {
+                if (closed)
+                    return;
+                if (opening || scheduled) {
+                    dirty = true;
+                    return;
+                }
+                void enqueue(false);
+            });
+        }
+        finally {
+            subscriptionReady.resolve();
+        }
+        if (closed || signal.aborted) {
+            await close();
+            throw new CapabilityError('Runnable watch was cancelled while opening.', 'CANCELLED', { reason: 'runnable-watch-cancelled' });
+        }
+        await enqueue(true);
+        opening = false;
+        if (dirty && !closed)
+            void enqueue(false);
+        return close;
+    }
+    catch (cause) {
+        const cleanup = await settle(close);
+        if (!cleanup.ok)
+            throw new AggregateError([cause, cleanup.cause], 'Runnable watch admission and cleanup failed.', { cause });
+        throw cause;
+    }
+}
+export {} from "../../schemas/contracts/watch.js";
+//# sourceMappingURL=watch.js.map

package/dist/client/tracking/watch.js.map

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

package/dist/client/transport.d.ts

@@ -0,0 +1,14 @@
+import { type RuntimeRef } from "@vibesdotdev/kernel";
+import type { RunHandle, RunnableClientCreateRunOptions } from "../schemas/contracts/index.ts";
+export declare class RunnableTransport {
+    readonly runtime: RuntimeRef;
+    private readonly ensureLoaded;
+    private resolvedUrl;
+    private request;
+    private directRun;
+    constructor(runtime: RuntimeRef, ensureLoaded: () => Promise<void>);
+    load(): Promise<void>;
+    get eventsUrl(): string;
+    createRun(options: RunnableClientCreateRunOptions): Promise<RunHandle>;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/client/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/client/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEvE,OAAO,KAAK,EAAE,SAAS,EAAsC,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAKnI,qBAAa,iBAAiB;IAKjB,QAAQ,CAAC,OAAO,EAAE,UAAU;IAAE,OAAO,CAAC,QAAQ,CAAC,YAAY;IAJvE,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,SAAS,CAAmE;gBAE/D,OAAO,EAAE,UAAU,EAAmB,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC;IAEtF,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB3B,IAAI,SAAS,IAAI,MAAM,CAQtB;IAEK,SAAS,CAAC,OAAO,EAAE,8BAA8B,GAAG,OAAO,CAAC,SAAS,CAAC;CAK5E"}

package/dist/client/transport.js

@@ -0,0 +1,52 @@
+import { CapabilityError } from "@vibesdotdev/kernel";
+import { createRunner } from "../runtime/runner.js";
+import { RUNNABLE_HOST_CONTEXT_ID } from "../runtime/host.js";
+const EVENTS_PATH = '/api/events';
+export class RunnableTransport {
+    runtime;
+    ensureLoaded;
+    resolvedUrl = null;
+    request;
+    directRun;
+    constructor(runtime, ensureLoaded) {
+        this.runtime = runtime;
+        this.ensureLoaded = ensureLoaded;
+    }
+    async load() {
+        const host = await this.runtime.context(RUNNABLE_HOST_CONTEXT_ID);
+        if (host.transport === 'in-process') {
+            this.directRun = options => host.createRun(options);
+            return;
+        }
+        this.request = host.request;
+        let url;
+        try {
+            url = new URL(host.eventsUrl);
+        }
+        catch (error) {
+            throw new CapabilityError('Runnable host supplied invalid eventsUrl.', 'INVALID_INPUT', { reason: 'runnable-events-url-invalid', cause: error });
+        }
+        if (url.protocol !== 'http:' && url.protocol !== 'https:') {
+            throw new CapabilityError('Runnable eventsUrl must use http or https.', 'INVALID_INPUT', { reason: 'runnable-events-url-protocol-invalid', details: { protocol: url.protocol } });
+        }
+        this.resolvedUrl = url.pathname !== '/'
+            ? url.toString()
+            : new URL(EVENTS_PATH, url).toString();
+    }
+    get eventsUrl() {
+        if (this.directRun) {
+            throw new CapabilityError('The selected in-process host has no HTTP event endpoint.', 'UNAVAILABLE', { reason: 'runnable-events-url-unavailable' });
+        }
+        if (!this.resolvedUrl) {
+            throw new CapabilityError('Runnable client is not loaded.', 'INTERNAL', { reason: 'runnable-client-not-loaded' });
+        }
+        return this.resolvedUrl;
+    }
+    async createRun(options) {
+        await this.ensureLoaded();
+        if (this.directRun)
+            return this.directRun(options);
+        return createRunner({ ...options, url: this.eventsUrl, lifecycle: this.runtime.lifecycle, request: this.request });
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/client/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/client/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAmB,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,wBAAwB,EAA4B,MAAM,oBAAoB,CAAC;AAExF,MAAM,WAAW,GAAG,aAAa,CAAC;AAElC,MAAM,OAAO,iBAAiB;IAKR;IAAsC;IAJnD,WAAW,GAAkB,IAAI,CAAC;IAClC,OAAO,CAA8B;IACrC,SAAS,CAAmE;IAEpF,YAAqB,OAAmB,EAAmB,YAAiC;QAAvE,YAAO,GAAP,OAAO,CAAY;QAAmB,iBAAY,GAAZ,YAAY,CAAqB;IAAG,CAAC;IAEhG,KAAK,CAAC,IAAI;QACT,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAsB,wBAAwB,CAAC,CAAC;QACvF,IAAI,IAAI,CAAC,SAAS,KAAK,YAAY,EAAE,CAAC;YACrC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACpD,OAAO;QACR,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,GAAQ,CAAC;QACb,IAAI,CAAC;YACJ,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,eAAe,CAAC,2CAA2C,EAAE,eAAe,EAAE,EAAE,MAAM,EAAE,6BAA6B,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAClJ,CAAC;QACD,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC3D,MAAM,IAAI,eAAe,CAAC,4CAA4C,EAAE,eAAe,EAAE,EAAE,MAAM,EAAE,sCAAsC,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACnL,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC,QAAQ,KAAK,GAAG;YACtC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE;YAChB,CAAC,CAAC,IAAI,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;IACzC,CAAC;IAED,IAAI,SAAS;QACZ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,eAAe,CAAC,0DAA0D,EAAE,aAAa,EAAE,EAAE,MAAM,EAAE,iCAAiC,EAAE,CAAC,CAAC;QACrJ,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACvB,MAAM,IAAI,eAAe,CAAC,gCAAgC,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,4BAA4B,EAAE,CAAC,CAAC;QACnH,CAAC;QACD,OAAO,IAAI,CAAC,WAAW,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAuC;QACtD,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACnD,OAAO,YAAY,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IACpH,CAAC;CACD"}