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

package/dist/records/query.d.ts

@@ -0,0 +1,11 @@
+import { type RunnableCatalogRun, type RunnableTrackedRun, type RunnableReadQuery } from '../schemas/runs.ts';
+import type { JsonValue } from '@vibesdotdev/kernel/schemas/json';
+/** Project already-authorized owner rows; unknown filters are refused at the schema boundary. */
+export declare function queryRunRecords<T extends RunnableTrackedRun>(records: T[], input: RunnableReadQuery): T[];
+/** Filter already-authorized catalog facts; evidence is requested only by matching filters. */
+export declare function queryRunSummaries<T extends RunnableCatalogRun>(records: T[], input: RunnableReadQuery, facts: (record: T) => {
+    input?: JsonValue;
+    about?: JsonValue;
+    host?: string;
+}): T[];
+//# sourceMappingURL=query.d.ts.map

package/dist/records/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/records/query.ts"],"names":[],"mappings":"AAEA,OAAO,EAA+C,KAAK,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC3J,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAElE,iGAAiG;AACjG,wBAAgB,eAAe,CAAC,CAAC,SAAS,kBAAkB,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,iBAAiB,GAAG,CAAC,EAAE,CASzG;AAED,+FAA+F;AAC/F,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,kBAAkB,EAC7D,OAAO,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,iBAAiB,EACtC,KAAK,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK;IAAE,KAAK,CAAC,EAAE,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3E,CAAC,EAAE,CAgCL"}

package/dist/records/query.js

@@ -0,0 +1,60 @@
+import { canonical } from "../identity.js";
+import { RUN_ADMISSION_METADATA_KEY } from "./authority.js";
+import { RunAdmissionSchema, RunnableReadQuerySchema } from "../schemas/runs.js";
+/** Project already-authorized owner rows; unknown filters are refused at the schema boundary. */
+export function queryRunRecords(records, input) {
+    return queryRunSummaries(records, input, record => {
+        const admission = RunAdmissionSchema.safeParse(record.metadata[RUN_ADMISSION_METADATA_KEY]);
+        return {
+            input: record.metadata['runnable.submittedInput'] ?? record.config,
+            about: record.metadata.about ?? null,
+            host: admission.success ? admission.data.workspace?.remoteHostId : undefined
+        };
+    });
+}
+/** Filter already-authorized catalog facts; evidence is requested only by matching filters. */
+export function queryRunSummaries(records, input, facts) {
+    const query = RunnableReadQuerySchema.strict().parse(input);
+    const subtree = new Set();
+    if (query.under !== undefined) {
+        subtree.add(query.under);
+        let changed = true;
+        while (changed) {
+            changed = false;
+            for (const record of records) {
+                if (record.parentRunId && subtree.has(record.parentRunId) && !subtree.has(record.id)) {
+                    subtree.add(record.id);
+                    changed = true;
+                }
+            }
+        }
+    }
+    return records.filter(record => {
+        if (query.id !== undefined && record.id !== query.id)
+            return false;
+        if (query.runnable !== undefined && record.runnableId !== query.runnable)
+            return false;
+        if (query.type !== undefined && record.runnableType !== query.type)
+            return false;
+        if (query.parentRunId !== undefined && record.parentRunId !== query.parentRunId)
+            return false;
+        if (query.under !== undefined && !subtree.has(record.id))
+            return false;
+        if (query.inputDigest !== undefined && record.inputDigest !== query.inputDigest)
+            return false;
+        if (query.since !== undefined && record.startedAt < query.since)
+            return false;
+        if (query.status !== undefined && record.outcome?.status !== query.status)
+            return false;
+        if (query.input !== undefined && canonical(facts(record).input) !== canonical(query.input))
+            return false;
+        if (query.about !== undefined && canonical(facts(record).about ?? null) !== canonical(query.about))
+            return false;
+        if (query.host !== undefined) {
+            if (record.hostId !== query.host && facts(record).host !== query.host)
+                return false;
+        }
+        return true;
+    }).sort((left, right) => right.startedAt - left.startedAt || left.id.localeCompare(right.id));
+}
+//# sourceMappingURL=query.js.map

package/dist/records/query.js.map

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

package/dist/runnable.cloud.plugin.d.ts

@@ -0,0 +1,3 @@
+/** Scope-pure Runnable composition; process supervision belongs to the consumer slice. */
+export { default } from './plugin.ts';
+//# sourceMappingURL=runnable.cloud.plugin.d.ts.map

package/dist/runnable.cloud.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runnable.cloud.plugin.d.ts","sourceRoot":"","sources":["../src/runnable.cloud.plugin.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC"}

package/dist/runnable.cloud.plugin.js

@@ -0,0 +1,3 @@
+/** Scope-pure Runnable composition; process supervision belongs to the consumer slice. */
+export { default } from "./plugin.js";
+//# sourceMappingURL=runnable.cloud.plugin.js.map

package/dist/runnable.cloud.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runnable.cloud.plugin.js","sourceRoot":"","sources":["../src/runnable.cloud.plugin.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC"}

package/dist/runnable.consumer.plugin.d.ts

@@ -0,0 +1,15 @@
+import common from './plugin.ts';
+declare const _default: {
+    onRegister(runtime: Parameters<NonNullable<typeof common.onRegister>>[0]): Promise<void>;
+    id: string;
+    name?: string;
+    description?: string;
+    dependencies?: readonly string[];
+    optionalDependencies?: readonly string[];
+    kinds?: import("@vibesdotdev/kernel").AnyRuntimeKindDescriptor[];
+    onActivate?: (runtime: import("@vibesdotdev/kernel").RuntimeRef) => void | Promise<void>;
+    onDispose?: (runtime: import("@vibesdotdev/kernel").RuntimeRef) => void | Promise<void>;
+    onRetire?: (runtime: import("@vibesdotdev/kernel").RuntimeRef) => void | Promise<void>;
+};
+export default _default;
+//# sourceMappingURL=runnable.consumer.plugin.d.ts.map

package/dist/runnable.consumer.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runnable.consumer.plugin.d.ts","sourceRoot":"","sources":["../src/runnable.consumer.plugin.ts"],"names":[],"mappings":"AACA,OAAO,MAAM,MAAM,aAAa,CAAC;;wBAUN,UAAU,CAAC,WAAW,CAAC,OAAO,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;;;;;;;;;;;AAF/E,wBAME"}

package/dist/runnable.consumer.plugin.js

@@ -0,0 +1,15 @@
+import { createRuntimePlugin, loader } from '@vibesdotdev/kernel';
+import common from "./plugin.js";
+import { RUNNABLE_SUPERVISOR_ID } from "./execution.contract.js";
+const consumer = createRuntimePlugin({
+    id: common.id,
+    loaders: [loader(RUNNABLE_SUPERVISOR_ID, { kind: 'runnable/supervisor', scope: 'consumer' }, () => import("./execution.js"))]
+});
+export default {
+    ...common,
+    async onRegister(runtime) {
+        await common.onRegister?.(runtime);
+        await consumer.onRegister?.(runtime);
+    }
+};
+//# sourceMappingURL=runnable.consumer.plugin.js.map

package/dist/runnable.consumer.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runnable.consumer.plugin.js","sourceRoot":"","sources":["../src/runnable.consumer.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,MAAM,QAAQ,GAAG,mBAAmB,CAAC;IACpC,EAAE,EAAE,MAAM,CAAC,EAAE;IACb,OAAO,EAAE,CAAC,MAAM,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,KAAK,EAAE,UAAU,EAAE,EAC1F,GAAG,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC;CACjC,CAAC,CAAC;AACH,eAAe;IACd,GAAG,MAAM;IACT,KAAK,CAAC,UAAU,CAAC,OAA6D;QAC7E,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,CAAC;QACnC,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;CACD,CAAC"}

package/dist/runnable.plugin.d.ts

@@ -0,0 +1,3 @@
+/** Historical public entrypoint for the same complete consumer composition. */
+export { default } from './runnable.consumer.plugin.ts';
+//# sourceMappingURL=runnable.plugin.d.ts.map

package/dist/runnable.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runnable.plugin.d.ts","sourceRoot":"","sources":["../src/runnable.plugin.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/runnable.plugin.js

@@ -0,0 +1,3 @@
+/** Historical public entrypoint for the same complete consumer composition. */
+export { default } from "./runnable.consumer.plugin.js";
+//# sourceMappingURL=runnable.plugin.js.map

package/dist/runnable.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runnable.plugin.js","sourceRoot":"","sources":["../src/runnable.plugin.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/runner.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Runner harness — emit events to a runnable ingest endpoint with retry.
+ *
+ * Usage:
+ *   const run = createRunner({ url: 'http://runnable.vibes.local/api/events' });
+ *   await run.start({ name: 'My Run', config: { lr: 0.001 } });
+ *   await run.metric('loss', 0.42);
+ *   await run.log('info', 'Epoch 5 complete');
+ *   await run.done();
+ */
+import type { RunHandle, RunnerOptions } from './schemas/contracts.ts';
+export declare function createRunner(options: RunnerOptions): RunHandle;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAKvE,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,CA2I9D"}

package/dist/runner.js

@@ -0,0 +1,151 @@
+/**
+ * Runner harness — emit events to a runnable ingest endpoint with retry.
+ *
+ * Usage:
+ *   const run = createRunner({ url: 'http://runnable.vibes.local/api/events' });
+ *   await run.start({ name: 'My Run', config: { lr: 0.001 } });
+ *   await run.metric('loss', 0.42);
+ *   await run.log('info', 'Epoch 5 complete');
+ *   await run.done();
+ */
+import { generateShortId as generateId } from '@vibesdotdev/shared';
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { RunEventOccurrenceSchema } from "./schemas/contracts.js";
+export function createRunner(options) {
+    const runId = options.runId ?? generateId();
+    const retryMax = options.retryMax ?? 10;
+    const retryBaseMs = options.retryBaseMs ?? 1000;
+    const retryMaxMs = options.retryMaxMs ?? 30000;
+    const buffer = [];
+    let flushTail = Promise.resolve({ ok: true });
+    async function send(event, eventId) {
+        const payload = { ...event, run_id: runId, event_id: eventId ?? generateId() };
+        if (options.executionGeneration !== undefined)
+            payload.execution_generation = options.executionGeneration;
+        if (options.executionAttempt !== undefined)
+            payload.execution_attempt = options.executionAttempt;
+        buffer.push(payload);
+        // Every send waits on the shared flush chain, so one caller's `done()`
+        // cannot interleave with an earlier event's retry loop and report
+        // completion before the event actually arrived.
+        return scheduleFlush();
+    }
+    function scheduleFlush() {
+        // A failed outcome was already delivered to its caller and the batch
+        // remains queued; the next caller intentionally tries that batch again.
+        const run = flushTail.then(() => doFlush());
+        flushTail = run;
+        return run.then((outcome) => {
+            if (!outcome.ok)
+                throw outcome.error;
+        });
+    }
+    async function postBatch(batch) {
+        try {
+            if (options.dispatch !== undefined) {
+                await options.dispatch(batch);
+                return { ok: true };
+            }
+            const body = batch.length === 1 ? JSON.stringify(batch[0]) : JSON.stringify(batch);
+            const res = await (options.request ?? fetch)(options.url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body
+            });
+            // Always drain the body so SvelteKit / workerd don't drop the socket.
+            await res.text();
+            if (!res.ok)
+                return { ok: false, error: new CapabilityError('Runnable ingest request failed.', 'UNAVAILABLE', { reason: 'runnable-ingest-request-failed', details: { status: res.status } }) };
+            return { ok: true };
+        }
+        catch (error) {
+            return { ok: false, error };
+        }
+    }
+    async function doFlush() {
+        if (buffer.length === 0)
+            return { ok: true };
+        let attempt = 0;
+        while (buffer.length > 0 && attempt < retryMax) {
+            const batch = buffer.splice(0, Math.min(buffer.length, 50));
+            const outcome = await postBatch(batch);
+            if (outcome.ok) {
+                attempt = 0;
+                continue;
+            }
+            // Preserve the failed events ahead of any later events. Exhaustion is
+            // surfaced to this caller; a later send retries the retained batch.
+            buffer.unshift(...batch);
+            if (attempt + 1 >= retryMax)
+                return outcome;
+            const delay = Math.min(retryBaseMs * Math.pow(2, attempt), retryMaxMs);
+            try {
+                await options.lifecycle.delay(delay);
+            }
+            catch (delayFailure) {
+                return {
+                    ok: false,
+                    error: new AggregateError([outcome.error, delayFailure], 'Runnable ingest request and retry delay failed')
+                };
+            }
+            attempt++;
+        }
+        return { ok: true };
+    }
+    return {
+        runId,
+        async start(config) {
+            const event = {
+                type: 'start',
+                name: options.name ?? runId,
+                config: config ?? {}
+            };
+            if (options.type !== undefined)
+                event.runnable_type = options.type;
+            await send(event);
+        },
+        async metric(key, value, dimensions) {
+            const event = { type: 'metric', key, value, timestamp: Date.now() };
+            if (dimensions && Object.keys(dimensions).length > 0)
+                event.dimensions = dimensions;
+            await send(event);
+        },
+        async log(level, message, data) {
+            const event = { type: 'log', level, message, timestamp: Date.now() };
+            if (data !== undefined)
+                event.data = data;
+            await send(event);
+        },
+        async status(status, message) {
+            const event = { type: 'status', status, timestamp: Date.now() };
+            if (message !== undefined)
+                event.message = message;
+            await send(event);
+        },
+        async progress(fraction, message) {
+            const event = { type: 'progress', fraction };
+            if (message !== undefined)
+                event.message = message;
+            await send(event);
+        },
+        async artifact(name, mimeType, data) {
+            const event = { type: 'artifact', name };
+            if (mimeType !== undefined)
+                event.mime_type = mimeType;
+            if (data !== undefined)
+                event.data = data;
+            await send(event);
+        },
+        async event(type, payload, occurrence) {
+            const admitted = occurrence === undefined ? undefined : RunEventOccurrenceSchema.parse(occurrence);
+            await send({ ...payload, type, timestamp: admitted?.timestamp ?? Date.now() }, admitted?.eventId);
+        },
+        async done(opts) {
+            const event = { type: 'done' };
+            if (opts?.summary !== undefined)
+                event.summary = opts.summary;
+            await send(event);
+        }
+    };
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

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

package/dist/runtime/change-source.d.ts

@@ -0,0 +1,39 @@
+import { type RunnableChangePurpose } from '../schemas/contracts/events.ts';
+import type { RuntimeRef } from '@vibesdotdev/kernel';
+import type { RunExecutionReference } from '../schemas/runs.ts';
+/** Invalidation only. Reads still pass through the selected tracking owner's authorization. */
+export declare const RUNNABLE_CHANGE_SOURCE_CONTEXT_ID = "runnable/change-source";
+export declare const RUNNABLE_CHANGE_EVENT = "runnable.owner.changed";
+export declare const runnableChangeSourceDescriptor: {
+    id: string;
+    kind: "context";
+    name?: string | undefined;
+    description?: string | undefined;
+    tags?: string[] | undefined;
+    hardware?: string[] | undefined;
+    enabled?: boolean | undefined;
+    priority?: number | undefined;
+    capabilityId?: string | undefined;
+    requiredContext?: string[] | undefined;
+    optionalContext?: string[] | undefined;
+    retention?: string | {
+        reason: string;
+        maxAgeDays?: number | undefined;
+        maxEntries?: number | undefined;
+        maxBytes?: number | undefined;
+        cascadeFrom?: string | undefined;
+        ageField?: string | undefined;
+        enforcedBy?: string | undefined;
+    } | undefined;
+    valueKind?: "data" | "service" | undefined;
+    valueSchema?: unknown;
+    config?: {
+        sources: ("literal" | "workspace" | "floor")[];
+        subset?: true | undefined;
+    } | undefined;
+};
+/** Persist first, then invalidate readers through the selected host's existing transport. */
+export declare function notifyRunnableChange(runtime: RuntimeRef, reference?: RunExecutionReference, purpose?: RunnableChangePurpose): Promise<void>;
+export declare function subscribeRunnableChanges(runtime: RuntimeRef, changed: (nativeReference?: RunExecutionReference) => void, purpose?: 'catalog' | 'native'): Promise<() => Promise<void>>;
+export { RunnableChangePurposeSchema, RunnableChangeNotificationSchema, type RunnableChangePurpose, type RunnableChangeSource } from '../schemas/contracts/events.ts';
+//# sourceMappingURL=change-source.d.ts.map

package/dist/runtime/change-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-source.d.ts","sourceRoot":"","sources":["../../src/runtime/change-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,qBAAqB,EAA6B,MAAM,gCAAgC,CAAC;AAEpI,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhE,+FAA+F;AAC/F,eAAO,MAAM,iCAAiC,2BAA2B,CAAC;AAC1E,eAAO,MAAM,qBAAqB,2BAA2B,CAAC;AAC9D,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;CAGzC,CAAC;AACH,6FAA6F;AAC7F,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,qBAAqB,EAAE,OAAO,GAAE,qBAAiC,GAAG,OAAO,CAAC,IAAI,CAAC,CAM5J;AAED,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,eAAe,CAAC,EAAE,qBAAqB,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAc5L;AAED,OAAO,EAAE,2BAA2B,EAAE,gCAAgC,EAAE,KAAK,qBAAqB,EAAE,KAAK,oBAAoB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/runtime/change-source.js

@@ -0,0 +1,36 @@
+import { RunnableChangePurposeSchema } from "../schemas/contracts/events.js";
+import { createContextDescriptor } from '@vibesdotdev/kernel/factory/context';
+import { resolveRunnableEventBroker } from "./event-broker.js";
+/** Invalidation only. Reads still pass through the selected tracking owner's authorization. */
+export const RUNNABLE_CHANGE_SOURCE_CONTEXT_ID = 'runnable/change-source';
+export const RUNNABLE_CHANGE_EVENT = 'runnable.owner.changed';
+export const runnableChangeSourceDescriptor = createContextDescriptor({
+    id: RUNNABLE_CHANGE_SOURCE_CONTEXT_ID,
+    description: 'Notifications from the existing execution host for persisted Runnable changes.'
+});
+/** Persist first, then invalidate readers through the selected host's existing transport. */
+export async function notifyRunnableChange(runtime, reference, purpose = 'catalog') {
+    const admitted = RunnableChangePurposeSchema.parse(purpose);
+    (await resolveRunnableEventBroker(runtime)).notify(admitted);
+    if (runtime.hasContext(RUNNABLE_CHANGE_SOURCE_CONTEXT_ID)) {
+        await (await runtime.context(RUNNABLE_CHANGE_SOURCE_CONTEXT_ID)).publish(reference, admitted);
+    }
+}
+export async function subscribeRunnableChanges(runtime, changed, purpose) {
+    const stopLocal = (await resolveRunnableEventBroker(runtime)).subscribe(changed, purpose);
+    try {
+        const stopHost = runtime.hasContext(RUNNABLE_CHANGE_SOURCE_CONTEXT_ID)
+            ? await (await runtime.context(RUNNABLE_CHANGE_SOURCE_CONTEXT_ID)).subscribe(changed, purpose)
+            : undefined;
+        return async () => {
+            stopLocal();
+            await stopHost?.();
+        };
+    }
+    catch (cause) {
+        stopLocal();
+        throw cause;
+    }
+}
+export { RunnableChangePurposeSchema, RunnableChangeNotificationSchema } from "../schemas/contracts/events.js";
+//# sourceMappingURL=change-source.js.map

package/dist/runtime/change-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-source.js","sourceRoot":"","sources":["../../src/runtime/change-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAyD,MAAM,gCAAgC,CAAC;AACpI,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAE9E,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAG/D,+FAA+F;AAC/F,MAAM,CAAC,MAAM,iCAAiC,GAAG,wBAAwB,CAAC;AAC1E,MAAM,CAAC,MAAM,qBAAqB,GAAG,wBAAwB,CAAC;AAC9D,MAAM,CAAC,MAAM,8BAA8B,GAAG,uBAAuB,CAAC;IACrE,EAAE,EAAE,iCAAiC;IACrC,WAAW,EAAE,gFAAgF;CAC7F,CAAC,CAAC;AACH,6FAA6F;AAC7F,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAAmB,EAAE,SAAiC,EAAE,UAAiC,SAAS;IAC5I,MAAM,QAAQ,GAAG,2BAA2B,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5D,CAAC,MAAM,0BAA0B,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7D,IAAI,OAAO,CAAC,UAAU,CAAC,iCAAiC,CAAC,EAAE,CAAC;QAC3D,MAAM,CAAC,MAAM,OAAO,CAAC,OAAO,CAAuB,iCAAiC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACrH,CAAC;AACF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,OAAmB,EAAE,OAA0D,EAAE,OAA8B;IAC7J,MAAM,SAAS,GAAG,CAAC,MAAM,0BAA0B,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1F,IAAI,CAAC;QACJ,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,iCAAiC,CAAC;YACrE,CAAC,CAAC,MAAM,CAAC,MAAM,OAAO,CAAC,OAAO,CAAuB,iCAAiC,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC;YACpH,CAAC,CAAC,SAAS,CAAC;QACb,OAAO,KAAK,IAAI,EAAE;YACjB,SAAS,EAAE,CAAC;YACZ,MAAM,QAAQ,EAAE,EAAE,CAAC;QACpB,CAAC,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,SAAS,EAAE,CAAC;QACZ,MAAM,KAAK,CAAC;IACb,CAAC;AACF,CAAC;AAED,OAAO,EAAE,2BAA2B,EAAE,gCAAgC,EAAyD,MAAM,gCAAgC,CAAC"}

package/dist/runtime/event-broker.d.ts

@@ -0,0 +1,41 @@
+import type { RunnableChangePurpose } from '../schemas/contracts/events.ts';
+import { type RunnableBrokerEvent, type RunnableEventBroker } from "../schemas/contracts/events.ts";
+import { type KindContext, type RuntimeDescriptor, type RuntimeRef } from "@vibesdotdev/kernel";
+import type { RuntimeKindDescriptorRecord } from "@vibesdotdev/kernel/schemas/kind";
+export declare const RUNNABLE_EVENT_BROKER_ID = "runnable-events";
+export declare const RUNNABLE_HEARTBEAT_INTERVAL_MS = 15000;
+export declare const runnableEventBrokerDescriptor: {
+    readonly id: "runnable-events";
+    readonly kind: "runnable/event-broker";
+    readonly description: "Runtime-local authenticated Runnable event and state stream.";
+};
+export declare const runnableEventBrokerKind: RuntimeKindDescriptorRecord;
+export declare class RuntimeLocalRunnableEventBroker implements RunnableEventBroker {
+    readonly descriptor: RuntimeDescriptor;
+    private readonly subscribers;
+    private readonly clients;
+    private readonly runOwners;
+    private readonly stateHost;
+    private stopHeartbeat;
+    private readonly runtime;
+    constructor(descriptor: RuntimeDescriptor, context: KindContext);
+    createStream(userId: string | null): Response;
+    broadcast(event: RunnableBrokerEvent, runId?: string): void;
+    broadcastSnapshot(): void;
+    setRunOwner(runId: string, userId: string | null): void;
+    clearRunOwner(runId: string): void;
+    getRunOwner(runId: string): string | null | undefined;
+    clientCount(): number;
+    subscribe(changed: () => void, purpose?: 'catalog' | 'native'): () => void;
+    notify(purpose?: RunnableChangePurpose): void;
+    dispose(): void;
+    private canReceive;
+    private scopeSnapshot;
+    private snapshot;
+    private ensureHeartbeat;
+    private stopHeartbeatWhenIdle;
+}
+export declare function resolveRunnableEventBroker(runtime: RuntimeRef): Promise<RunnableEventBroker>;
+export default RuntimeLocalRunnableEventBroker;
+export { RunnableBrokerEventSchema, type RunnableBrokerEvent, type RunnableEventBroker } from '../schemas/contracts/events.ts';
+//# sourceMappingURL=event-broker.d.ts.map

package/dist/runtime/event-broker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-broker.d.ts","sourceRoot":"","sources":["../../src/runtime/event-broker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EAA6B,KAAK,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC/H,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,iBAAiB,EAAE,KAAK,UAAU,EAA2B,MAAM,qBAAqB,CAAC;AACzH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAIpF,eAAO,MAAM,wBAAwB,oBAAoB,CAAC;AAC1D,eAAO,MAAM,8BAA8B,QAAS,CAAC;AAErD,eAAO,MAAM,6BAA6B;;;;CAIhC,CAAC;AAEX,eAAO,MAAM,uBAAuB,EAAE,2BAIrC,CAAC;AAeF,qBAAa,+BAAgC,YAAW,mBAAmB;IASzE,QAAQ,CAAC,UAAU,EAAE,iBAAiB;IARvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+C;IAC3E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAC9D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2B;IACrD,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;gBAG3B,UAAU,EAAE,iBAAiB,EACtC,OAAO,EAAE,WAAW;IAOrB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ;IA0B7C,SAAS,CAAC,KAAK,EAAE,mBAAmB,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAa3D,iBAAiB,IAAI,IAAI;IAWzB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IACvD,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAClC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS;IACrD,WAAW,IAAI,MAAM;IACrB,SAAS,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,OAAO,GAAE,SAAS,GAAG,QAAmB,GAAG,MAAM,IAAI;IAIpF,MAAM,CAAC,OAAO,GAAE,qBAAiC,GAAG,IAAI;IAUxD,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,qBAAqB;CAK7B;AAED,wBAAsB,0BAA0B,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAGlG;AAED,eAAe,+BAA+B,CAAC;AAE/C,OAAO,EAAE,yBAAyB,EAAE,KAAK,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/runtime/event-broker.js

@@ -0,0 +1,157 @@
+import { RunnableBrokerEventSchema } from "../schemas/contracts/events.js";
+import { settleNow as settleSync } from "@vibesdotdev/kernel";
+import { RunnableEventBrokerDescriptorSchema } from "../schemas/descriptors.js";
+import { RUNNABLE_STATE_HOST_CONTEXT_ID } from "./host.js";
+export const RUNNABLE_EVENT_BROKER_ID = 'runnable-events';
+export const RUNNABLE_HEARTBEAT_INTERVAL_MS = 15_000;
+export const runnableEventBrokerDescriptor = {
+    id: RUNNABLE_EVENT_BROKER_ID,
+    kind: 'runnable/event-broker',
+    description: 'Runtime-local authenticated Runnable event and state stream.'
+};
+export const runnableEventBrokerKind = {
+    id: 'runnable/event-broker',
+    descriptorSchema: RunnableEventBrokerDescriptorSchema,
+    contexts: [RUNNABLE_STATE_HOST_CONTEXT_ID]
+};
+function brokerEvent(value) {
+    return RunnableBrokerEventSchema.parse(value);
+}
+function frame(eventType, data) {
+    return new TextEncoder().encode(`event: ${eventType}\ndata: ${JSON.stringify(data)}\n\n`);
+}
+export class RuntimeLocalRunnableEventBroker {
+    descriptor;
+    subscribers = new Map();
+    clients = new Set();
+    runOwners = new Map();
+    stateHost;
+    stopHeartbeat = null;
+    runtime;
+    constructor(descriptor, context) {
+        this.descriptor = descriptor;
+        // SAFETY: RUNNABLE_STATE_HOST_CONTEXT_ID is declared in kind contexts and guaranteed by runtime
+        this.stateHost = context[RUNNABLE_STATE_HOST_CONTEXT_ID];
+        this.runtime = context.runtime;
+    }
+    createStream(userId) {
+        this.ensureHeartbeat();
+        let client;
+        const stream = new ReadableStream({
+            start: (controller) => {
+                client = { controller, userId };
+                this.clients.add(client);
+                const outcome = settleSync(() => controller.enqueue(frame('state', brokerEvent(this.scopeSnapshot(this.snapshot(), userId)))));
+                if (!outcome.ok) {
+                    this.clients.delete(client);
+                }
+            },
+            cancel: () => {
+                this.clients.delete(client);
+                this.stopHeartbeatWhenIdle();
+            }
+        });
+        return new Response(stream, {
+            headers: {
+                'Content-Type': 'text/event-stream',
+                'Cache-Control': 'no-cache',
+                Connection: 'keep-alive'
+            }
+        });
+    }
+    broadcast(event, runId) {
+        this.notify();
+        const payload = brokerEvent(runId === undefined ? event : { ...event, run_id: runId });
+        const encoded = frame(String(event.type ?? 'event'), payload);
+        const ownerId = runId ? this.runOwners.get(runId) : undefined;
+        for (const client of this.clients) {
+            if (!this.canReceive(client.userId, ownerId))
+                continue;
+            const outcome = settleSync(() => client.controller.enqueue(encoded));
+            if (!outcome.ok)
+                this.clients.delete(client);
+        }
+        this.stopHeartbeatWhenIdle();
+    }
+    broadcastSnapshot() {
+        this.notify();
+        if (this.clients.size === 0)
+            return;
+        const snapshot = this.snapshot();
+        for (const client of this.clients) {
+            const outcome = settleSync(() => client.controller.enqueue(frame('state', brokerEvent(this.scopeSnapshot(snapshot, client.userId)))));
+            if (!outcome.ok)
+                this.clients.delete(client);
+        }
+        this.stopHeartbeatWhenIdle();
+    }
+    setRunOwner(runId, userId) { this.runOwners.set(runId, userId); }
+    clearRunOwner(runId) { this.runOwners.delete(runId); }
+    getRunOwner(runId) { return this.runOwners.get(runId); }
+    clientCount() { return this.clients.size; }
+    subscribe(changed, purpose = 'native') {
+        this.subscribers.set(changed, purpose);
+        return () => { this.subscribers.delete(changed); };
+    }
+    notify(purpose = 'catalog') {
+        for (const [changed, projection] of this.subscribers) {
+            if (purpose === 'telemetry' && projection === 'catalog')
+                continue;
+            const delivered = settleSync(changed);
+            if (!delivered.ok)
+                this.runtime.diagnostics.error('Runnable change notification failed', {
+                    scope: 'runnable:events', plugin: 'runnable', error: delivered.cause
+                });
+        }
+    }
+    dispose() {
+        this.stopHeartbeat?.();
+        this.stopHeartbeat = null;
+        this.clients.clear();
+        this.runOwners.clear();
+        this.subscribers.clear();
+    }
+    canReceive(userId, ownerId) {
+        return !!userId && !!ownerId && userId === ownerId;
+    }
+    scopeSnapshot(snapshot, userId) {
+        if (!userId)
+            return { activeRuns: [], runCount: 0 };
+        const activeRuns = snapshot.activeRuns.filter((run) => this.runOwners.get(run.id) === userId);
+        return { activeRuns, runCount: activeRuns.length };
+    }
+    snapshot() {
+        const activeRuns = this.stateHost.state.getAllRuns().map((run) => run.state);
+        return { activeRuns, runCount: activeRuns.length };
+    }
+    ensureHeartbeat() {
+        if (this.stopHeartbeat)
+            return;
+        // A finite host starts no autonomous background work (`interval` refuses it); it serves no long-lived stream.
+        if (this.runtime.scope.lifecycle === 'finite')
+            return;
+        // Runtime-owned tick: ends with the runtime, or earlier when the last client leaves.
+        this.stopHeartbeat = this.runtime.lifecycle.interval(() => {
+            const encoded = new TextEncoder().encode(':heartbeat\n\n');
+            for (const client of this.clients) {
+                const outcome = settleSync(() => client.controller.enqueue(encoded));
+                if (!outcome.ok)
+                    this.clients.delete(client);
+            }
+            this.stopHeartbeatWhenIdle();
+        }, RUNNABLE_HEARTBEAT_INTERVAL_MS);
+    }
+    stopHeartbeatWhenIdle() {
+        if (this.clients.size > 0 || !this.stopHeartbeat)
+            return;
+        this.stopHeartbeat();
+        this.stopHeartbeat = null;
+    }
+}
+export async function resolveRunnableEventBroker(runtime) {
+    return runtime.query('runnable/event-broker')
+        .withId(RUNNABLE_EVENT_BROKER_ID).resolve();
+}
+export default RuntimeLocalRunnableEventBroker;
+export { RunnableBrokerEventSchema } from "../schemas/contracts/events.js";
+//# sourceMappingURL=event-broker.js.map