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

package/dist/runtime/plugins/plugin.js

@@ -0,0 +1,69 @@
+import hooksPlugin from '@vibesdotdev/kernel/hooks/hooks.plugin';
+import { RuntimeEventDescriptorSchema } from '@vibesdotdev/kernel/hooks/schemas';
+import { RUN_COMPLETED_EVENT, RunCompletedPayloadSchema } from "../../schemas/runs.js";
+import { cryptoPlugin } from '@vibesdotdev/crypto/plugin';
+import { createRuntimePlugin, loader } from "@vibesdotdev/kernel";
+import { runnableTypeKind } from "../../kinds/type.js";
+import { runnableKind } from "../../kinds/runnable.js";
+import { runnableConfigKind } from "../../kinds/config.js";
+import { runnableTelemetryKind } from "../../kinds/telemetry.js";
+import { runnableResultKind } from "../../kinds/result.js";
+import { runnableVisualizationKind } from "../../kinds/visualization.js";
+import { runnableIngestMappingKind } from "../../kinds/ingest-mapping.js";
+import { runnableExecutorKind, runnableSupervisorKind, runnableSupervisorDescriptor, } from "../execution/contract.js";
+import { runnableEventBrokerKind, runnableEventBrokerDescriptor, RUNNABLE_EVENT_BROKER_ID } from "../event-broker.js";
+import { runnableHostContextDescriptor, runnableStateHostContextDescriptor } from "../host.js";
+// Docs
+import runnableGraphsDocsDescriptor from "../../docs/runnable.graphs.docs.descriptor.js";
+import runnableNodesDocsDescriptor from "../../docs/runnable.nodes.docs.descriptor.js";
+import runnableContextDocsDescriptor from "../../docs/runnable.context.docs.descriptor.js";
+// Hoisted const: tsc rewriteRelativeImportExtensions does not rewrite `.ts` specifiers inside `export default <expr>` (TS 6.0.3).
+const defaultExport = createRuntimePlugin({
+    id: "runnable",
+    name: "Runnable Module",
+    description: "Infrastructure and kinds for complex background tasks (training, benchmarks, tests) and telemetry.",
+    dependencies: ['context', 'runtime-client'],
+    async onRegister(runtime) {
+        await runtime.registerPlugin(cryptoPlugin);
+        await runtime.registerPlugin(hooksPlugin);
+        runtime.registerDescriptor('runtime/event', RuntimeEventDescriptorSchema.parse({
+            kind: 'runtime/event',
+            id: RUN_COMPLETED_EVENT,
+            source: 'runnable.run',
+            trigger: 'custom',
+            payloadSchema: RunCompletedPayloadSchema
+        }));
+    },
+    kinds: [
+        runnableTypeKind,
+        runnableKind,
+        runnableConfigKind,
+        runnableTelemetryKind,
+        runnableResultKind,
+        runnableVisualizationKind,
+        runnableIngestMappingKind,
+        runnableExecutorKind,
+        runnableSupervisorKind,
+        runnableEventBrokerKind
+    ],
+    descriptors: [
+        runnableGraphsDocsDescriptor,
+        runnableNodesDocsDescriptor,
+        runnableContextDocsDescriptor,
+        runnableHostContextDescriptor,
+        runnableStateHostContextDescriptor,
+        runnableSupervisorDescriptor,
+        runnableEventBrokerDescriptor,
+        {
+            id: 'runnable',
+            kind: 'runtime/client',
+            description: 'Canonical Runnable telemetry, execution, control, and event client.'
+        }
+    ],
+    loaders: [
+        loader('runnable', { kind: 'runtime/client' }, () => import("../../client/client.js")),
+        loader(RUNNABLE_EVENT_BROKER_ID, { kind: 'runnable/event-broker' }, () => import("../event-broker.js"))
+    ]
+});
+export default defaultExport;
+//# sourceMappingURL=plugin.js.map

package/dist/runtime/plugins/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../src/runtime/plugins/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,wCAAwC,CAAC;AACjE,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EACN,oBAAoB,EACpB,sBAAsB,EACtB,4BAA4B,GAC5B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACN,uBAAuB,EACvB,6BAA6B,EAC7B,wBAAwB,EACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACN,6BAA6B,EAC7B,kCAAkC,EAClC,MAAM,YAAY,CAAC;AAEpB,OAAO;AACP,OAAO,4BAA4B,MAAM,+CAA+C,CAAC;AACzF,OAAO,2BAA2B,MAAM,8CAA8C,CAAC;AACvF,OAAO,6BAA6B,MAAM,gDAAgD,CAAC;AAE3F,kIAAkI;AAClI,MAAM,aAAa,GAAG,mBAAmB,CAAC;IACzC,EAAE,EAAE,UAAU;IACd,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACV,oGAAoG;IACrG,YAAY,EAAE,CAAC,SAAS,EAAE,gBAAgB,CAAC;IAC3C,KAAK,CAAC,UAAU,CAAC,OAAO;QACvB,MAAM,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;QAC3C,MAAM,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;QAC1C,OAAO,CAAC,kBAAkB,CAAC,eAAe,EAAE,4BAA4B,CAAC,KAAK,CAAC;YAC9E,IAAI,EAAE,eAAe;YACrB,EAAE,EAAE,mBAAmB;YACvB,MAAM,EAAE,cAAc;YACtB,OAAO,EAAE,QAAQ;YACjB,aAAa,EAAE,yBAAyB;SACxC,CAAC,CAAC,CAAC;IACL,CAAC;IACD,KAAK,EAAE;QACN,gBAAgB;QAChB,YAAY;QACZ,kBAAkB;QAClB,qBAAqB;QACrB,kBAAkB;QAClB,yBAAyB;QACzB,yBAAyB;QACzB,oBAAoB;QACpB,sBAAsB;QACtB,uBAAuB;KACvB;IACD,WAAW,EAAE;QACZ,4BAA4B;QAC5B,2BAA2B;QAC3B,6BAA6B;QAC7B,6BAA6B;QAC7B,kCAAkC;QAClC,4BAA4B;QAC5B,6BAA6B;QAC7B;YACC,EAAE,EAAE,UAAU;YACd,IAAI,EAAE,gBAAgB;YACtB,WAAW,EAAE,qEAAqE;SAClF;KACD;IACD,OAAO,EAAE;QACR,MAAM,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC;QACtF,MAAM,CACL,wBAAwB,EACxB,EAAE,IAAI,EAAE,uBAAuB,EAAE,EACjC,GAAG,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAClC;KACD;CACD,CAAC,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/dist/runtime/plugins/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/runtime/plugins/runnable.cloud.plugin.d.ts.map

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

package/dist/runtime/plugins/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/runtime/plugins/runnable.cloud.plugin.js.map

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

package/dist/runtime/plugins/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/runtime/plugins/runnable.consumer.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runnable.consumer.plugin.d.ts","sourceRoot":"","sources":["../../../src/runtime/plugins/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/runtime/plugins/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/index.js"))]
+});
+export default {
+    ...common,
+    async onRegister(runtime) {
+        await common.onRegister?.(runtime);
+        await consumer.onRegister?.(runtime);
+    }
+};
+//# sourceMappingURL=runnable.consumer.plugin.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runnable.consumer.plugin.js","sourceRoot":"","sources":["../../../src/runtime/plugins/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,0BAA0B,CAAC;AAElE,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,uBAAuB,CAAC,CAAC,CAAC;CACxC,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/runtime/plugins/runnable.metrics.plugin.d.ts

@@ -0,0 +1,4 @@
+/** Explicit composition: Metrics owns the kind, Runnable owns this implementation. */
+declare const runnableMetricsPlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export default runnableMetricsPlugin;
+//# sourceMappingURL=runnable.metrics.plugin.d.ts.map

package/dist/runtime/plugins/runnable.metrics.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runnable.metrics.plugin.d.ts","sourceRoot":"","sources":["../../../src/runtime/plugins/runnable.metrics.plugin.ts"],"names":[],"mappings":"AAGA,sFAAsF;AAEtF,QAAA,MAAM,qBAAqB,6CAMzB,CAAC;AAEH,eAAe,qBAAqB,CAAC"}

package/dist/runtime/plugins/runnable.metrics.plugin.js

@@ -0,0 +1,13 @@
+import { createRuntimePlugin, loader } from '@vibesdotdev/kernel';
+import { runnableMetricsDescriptor } from "../../metrics/runnable.metrics.descriptor.js";
+/** Explicit composition: Metrics owns the kind, Runnable owns this implementation. */
+// Bound before `export default`: tsc 6.0.3 leaves `.ts` dynamic-import specifiers unrewritten after an `export default <expression>`.
+const runnableMetricsPlugin = createRuntimePlugin({
+    id: 'runnable-metrics',
+    name: 'Runnable metrics source',
+    dependencies: ['runnable', 'metrics'],
+    descriptors: [runnableMetricsDescriptor],
+    loaders: [loader(runnableMetricsDescriptor.id, { kind: 'metrics/source' }, () => import("../../metrics/runnable.metrics.impl.js"))]
+});
+export default runnableMetricsPlugin;
+//# sourceMappingURL=runnable.metrics.plugin.js.map

package/dist/runtime/plugins/runnable.metrics.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runnable.metrics.plugin.js","sourceRoot":"","sources":["../../../src/runtime/plugins/runnable.metrics.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AAEzF,sFAAsF;AACtF,sIAAsI;AACtI,MAAM,qBAAqB,GAAG,mBAAmB,CAAC;IACjD,EAAE,EAAE,kBAAkB;IACtB,IAAI,EAAE,yBAAyB;IAC/B,YAAY,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC;IACrC,WAAW,EAAE,CAAC,yBAAyB,CAAC;IACxC,OAAO,EAAE,CAAC,MAAM,CAAC,yBAAyB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,wCAAwC,CAAC,CAAC,CAAC;CACnI,CAAC,CAAC;AAEH,eAAe,qBAAqB,CAAC"}

package/dist/runtime/plugins/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/runtime/plugins/runnable.plugin.d.ts.map

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

package/dist/runtime/plugins/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/runtime/plugins/runnable.plugin.js.map

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

package/dist/runtime/runner.d.ts

@@ -0,0 +1,13 @@
+import { type RunHandle, type RunnerOptions } from "../schemas/contracts/index.ts";
+/**
+ * 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();
+ */
+export declare function createRunner(options: RunnerOptions): RunHandle;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runtime/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/runtime/runner.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,aAAa,EAA4B,MAAM,+BAA+B,CAAC;AAE7G;;;;;;;;;GASG;AAEH,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,CA6I9D"}

package/dist/runtime/runner.js

@@ -0,0 +1,154 @@
+import { generateShortId as generateId } from "@vibesdotdev/shared";
+import { CapabilityError } from "@vibesdotdev/kernel";
+import { RunEventOccurrenceSchema } from "../schemas/contracts/index.js";
+/**
+ * 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();
+ */
+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;
+            // An ended lifecycle (runtime disposal) gets no retry: backing off would only spend its finalization budget.
+            if (options.lifecycle.signal?.aborted)
+                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/runtime/runner.js.map

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

package/dist/runtime/state/index.d.ts

@@ -0,0 +1,4 @@
+export { TieredTimeSeries, TIME_SERIES_TIERS } from './time-series.ts';
+export { RunnableStateManager } from './manager.ts';
+export { type TierSpec, type TieredBucket, type DataPoint, type TierStats, type SeriesStats, type AccumState, RUN_STATUS_VALUES, type KnownRunStatus, type RunStatus, type RunLogEntry, type MetricSeriesPoint, type MetricSeriesSnapshot, type RunStateEntry, RunStatePayloadSchema, type RunStatePayload, type RunStateSnapshot, type RunStateListEntry, type RecordStartFields, type GenericRunStateManager, type MetricSample } from '../../schemas/contracts/state.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/state/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/state/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,iBAAiB,EAAE,KAAK,cAAc,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,KAAK,iBAAiB,EAAE,KAAK,oBAAoB,EAAE,KAAK,aAAa,EAAE,qBAAqB,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,KAAK,YAAY,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/runtime/state/index.js

@@ -0,0 +1,4 @@
+export { TieredTimeSeries, TIME_SERIES_TIERS } from "./time-series.js";
+export { RunnableStateManager } from "./manager.js";
+export { RUN_STATUS_VALUES, RunStatePayloadSchema } from "../../schemas/contracts/state.js";
+//# sourceMappingURL=index.js.map

package/dist/runtime/state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/state/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAuG,iBAAiB,EAAgI,qBAAqB,EAA+I,MAAM,kCAAkC,CAAC"}

package/dist/runtime/state/manager.d.ts

@@ -0,0 +1,20 @@
+import type { GenericWrite } from "../../schemas/writes.ts";
+import type { GenericRunStateManager, RunStateEntry, RecordStartFields, RunStateSnapshot, RunStateListEntry } from "../../schemas/contracts/state.ts";
+/** One in-memory run projection per runtime, never a process-global singleton. */
+export declare class RunnableStateManager implements GenericRunStateManager {
+    private readonly runs;
+    private activeRunId;
+    recordStart(fields: RecordStartFields): void;
+    applyDispatch(runId: string, writes: GenericWrite[]): void;
+    setStatus(runId: string, status: string): void;
+    markDone(runId: string, ts?: number): void;
+    getRunById(runId: string): RunStateEntry | null;
+    getSnapshot(runId: string): RunStateSnapshot | null;
+    getAllRuns(): RunStateListEntry[];
+    getActiveRunId(): string | null;
+    injectRun(entry: RunStateEntry): void;
+    reset(): void;
+    get runCount(): number;
+    private applyWrite;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/runtime/state/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/runtime/state/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,sBAAsB,EAAE,aAAa,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,EAAe,MAAM,kCAAkC,CAAC;AAEnK,kFAAkF;AAClF,qBAAa,oBAAqB,YAAW,sBAAsB;IAC/D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoC;IACzD,OAAO,CAAC,WAAW,CAAuB;IAC1C,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAwB5C,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI;IAgB1D,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAgB9C,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,SAAa,GAAG,IAAI;IAW9C,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAC/C,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAInD,UAAU,IAAI,iBAAiB,EAAE;IASjC,cAAc,IAAI,MAAM,GAAG,IAAI;IAC/B,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAKrC,KAAK,IAAI,IAAI;IACb,IAAI,QAAQ,IAAI,MAAM,CAA2B;IACjD,OAAO,CAAC,UAAU;CAuCrB"}

package/dist/runtime/state/manager.js

@@ -0,0 +1,135 @@
+import { emptyRunStateEntry, newMetricSeries, snapshotRunState, TERMINAL_STATUSES, ACTIVE_RUN_THRESHOLD_MS, SNAPSHOT_LOG_TAIL } from "./snapshot.js";
+/** One in-memory run projection per runtime, never a process-global singleton. */
+export class RunnableStateManager {
+    runs = new Map();
+    activeRunId = null;
+    recordStart(fields) {
+        const existing = this.runs.get(fields.runId);
+        if (!existing) {
+            this.runs.set(fields.runId, emptyRunStateEntry(fields));
+        }
+        else {
+            existing.runnableType = fields.runnableType;
+            if (fields.runnableId)
+                existing.runnableId = fields.runnableId;
+            if (fields.name)
+                existing.name = fields.name;
+            if (fields.config)
+                existing.config = fields.config;
+            if (fields.metadata)
+                existing.metadata = { ...existing.metadata, ...fields.metadata };
+            if (fields.startedAt)
+                existing.startedAt = fields.startedAt;
+            existing.status = fields.status ?? 'running';
+            existing.endedAt = null;
+            existing.done = false;
+            existing.lastEventAt = fields.startedAt ?? Date.now();
+        }
+        this.activeRunId = fields.runId;
+    }
+    applyDispatch(runId, writes) {
+        if (writes.length === 0)
+            return;
+        let entry = this.runs.get(runId);
+        if (!entry) {
+            entry = emptyRunStateEntry({ runId, runnableType: 'unknown', status: 'running' });
+            this.runs.set(runId, entry);
+        }
+        let latestTs = 0;
+        for (const write of writes) {
+            this.applyWrite(entry, write);
+            if (write.kind !== 'lifecycle' && write.ts > latestTs)
+                latestTs = write.ts;
+        }
+        entry.lastEventAt = latestTs > 0 ? Math.max(entry.lastEventAt, latestTs) : Date.now();
+    }
+    setStatus(runId, status) {
+        const entry = this.runs.get(runId);
+        if (!entry)
+            return;
+        entry.status = status;
+        entry.lastEventAt = Date.now();
+        if (TERMINAL_STATUSES.has(status)) {
+            entry.done = true;
+            entry.endedAt = entry.lastEventAt;
+            if (this.activeRunId === runId)
+                this.activeRunId = null;
+        }
+        else if (status === 'running') {
+            this.activeRunId = runId;
+        }
+    }
+    markDone(runId, ts = Date.now()) {
+        const entry = this.runs.get(runId);
+        if (!entry)
+            return;
+        entry.status = 'completed';
+        entry.done = true;
+        entry.endedAt = ts;
+        entry.lastEventAt = ts;
+        if (this.activeRunId === runId)
+            this.activeRunId = null;
+    }
+    getRunById(runId) { return this.runs.get(runId) ?? null; }
+    getSnapshot(runId) {
+        const entry = this.runs.get(runId);
+        return entry ? snapshotRunState(entry) : null;
+    }
+    getAllRuns() {
+        const now = Date.now();
+        return Array.from(this.runs.values()).map((entry) => ({
+            id: entry.id,
+            state: snapshotRunState(entry),
+            active: entry.status === 'running' && !entry.done && entry.lastEventAt > 0
+                && now - entry.lastEventAt <= ACTIVE_RUN_THRESHOLD_MS
+        }));
+    }
+    getActiveRunId() { return this.activeRunId; }
+    injectRun(entry) {
+        this.runs.set(entry.id, entry);
+        if (entry.status === 'running' && !this.activeRunId)
+            this.activeRunId = entry.id;
+    }
+    reset() { this.runs.clear(); this.activeRunId = null; }
+    get runCount() { return this.runs.size; }
+    applyWrite(entry, write) {
+        if (write.kind === 'metric') {
+            let series = entry.metrics.get(write.key);
+            if (!series) {
+                series = newMetricSeries();
+                entry.metrics.set(write.key, series);
+            }
+            series.push({ value: write.value }, write.ts);
+        }
+        else if (write.kind === 'log') {
+            const log = { ts: write.ts, level: write.level, message: write.message };
+            if (write.data !== undefined)
+                log.data = write.data;
+            entry.logs.push(log);
+            if (entry.logs.length > SNAPSHOT_LOG_TAIL)
+                entry.logs.splice(0, entry.logs.length - SNAPSHOT_LOG_TAIL);
+        }
+        else if (write.kind === 'artifact') {
+            entry.artifactCount += 1;
+        }
+        else {
+            if (write.patch.status !== undefined) {
+                entry.status = write.patch.status;
+                if (TERMINAL_STATUSES.has(write.patch.status)) {
+                    entry.done = true;
+                    if (this.activeRunId === entry.id)
+                        this.activeRunId = null;
+                }
+            }
+            if (write.patch.activity && (!entry.activity || write.patch.activity.ts >= entry.activity.ts))
+                entry.activity = write.patch.activity;
+            if (write.patch.progress !== undefined)
+                entry.progress = write.patch.progress;
+            if (write.patch.endedAt !== undefined)
+                entry.endedAt = write.patch.endedAt;
+            if (write.patch.metadata !== undefined)
+                entry.metadata = { ...entry.metadata, ...write.patch.metadata };
+        }
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/runtime/state/manager.js.map

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

package/dist/runtime/state/snapshot.d.ts

@@ -0,0 +1,10 @@
+import type { MetricSample, RecordStartFields, RunStateEntry, RunStateSnapshot } from "../../schemas/contracts/state.ts";
+import { TieredTimeSeries } from "./time-series.ts";
+export declare const SNAPSHOT_LOG_TAIL = 200;
+export declare const SNAPSHOT_METRIC_TAIL = 200;
+export declare const ACTIVE_RUN_THRESHOLD_MS = 15000;
+export declare const TERMINAL_STATUSES: Set<string>;
+export declare function emptyRunStateEntry(fields: RecordStartFields): RunStateEntry;
+export declare function newMetricSeries(): TieredTimeSeries<MetricSample>;
+export declare function snapshotRunState(entry: RunStateEntry): RunStateSnapshot;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/runtime/state/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../src/runtime/state/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,gBAAgB,EAAwB,MAAM,kCAAkC,CAAC;AAC/I,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,eAAO,MAAM,uBAAuB,QAAQ,CAAC;AAC7C,eAAO,MAAM,iBAAiB,aAA6C,CAAC;AAE5E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,GAAG,aAAa,CAmB3E;AACD,wBAAgB,eAAe,IAAI,gBAAgB,CAAC,YAAY,CAAC,CAEhE;AACD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,gBAAgB,CA4BvE"}

package/dist/runtime/state/snapshot.js

@@ -0,0 +1,59 @@
+import { TieredTimeSeries } from "./time-series.js";
+export const SNAPSHOT_LOG_TAIL = 200;
+export const SNAPSHOT_METRIC_TAIL = 200;
+export const ACTIVE_RUN_THRESHOLD_MS = 15000;
+export const TERMINAL_STATUSES = new Set(['completed', 'stopped', 'error']);
+const METRIC_FIELD = 'value';
+export function emptyRunStateEntry(fields) {
+    const now = fields.startedAt ?? Date.now();
+    return {
+        id: fields.runId,
+        runnableType: fields.runnableType,
+        runnableId: fields.runnableId ?? fields.runnableType,
+        name: fields.name ?? fields.runId,
+        status: fields.status ?? 'running',
+        startedAt: now,
+        endedAt: null,
+        lastEventAt: now,
+        progress: 0,
+        config: fields.config ?? {},
+        metadata: fields.metadata ?? {},
+        metrics: new Map(),
+        logs: [],
+        artifactCount: 0,
+        done: false
+    };
+}
+export function newMetricSeries() {
+    return new TieredTimeSeries((metric) => ({ [METRIC_FIELD]: metric.value }));
+}
+export function snapshotRunState(entry) {
+    const metrics = {};
+    for (const [key, series] of entry.metrics) {
+        const points = series.getAll();
+        const tail = points.length > SNAPSHOT_METRIC_TAIL ? points.slice(-SNAPSHOT_METRIC_TAIL) : points;
+        metrics[key] = {
+            key,
+            values: tail.map((point) => ({ ts: point.ts, value: point.value[METRIC_FIELD] ?? 0 }))
+        };
+    }
+    return {
+        id: entry.id,
+        activity: entry.activity,
+        runnableType: entry.runnableType,
+        runnableId: entry.runnableId,
+        name: entry.name,
+        status: entry.status,
+        startedAt: entry.startedAt,
+        endedAt: entry.endedAt,
+        lastEventAt: entry.lastEventAt,
+        progress: entry.progress,
+        config: { ...entry.config },
+        metadata: { ...entry.metadata },
+        metrics,
+        logs: entry.logs.slice(-SNAPSHOT_LOG_TAIL),
+        artifactCount: entry.artifactCount,
+        done: entry.done
+    };
+}
+//# sourceMappingURL=snapshot.js.map