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

package/dist/schemas/contracts/host.d.ts

@@ -0,0 +1,37 @@
+import type { GenericRunStateManager, RunStateSnapshot } from "../../runtime/state/index.ts";
+import type { RunnableRequest, RunEmitterOptions, RunHandle } from "./index.ts";
+import type { RunnableRecords, RunnableTelemetryRecords, RunnableReadHost, RunnableTrackingHost } from "../runs.ts";
+/** The host explicitly chooses a direct owner port or authenticated HTTP transport. */
+export type RunnableHostContext = {
+    transport?: 'http';
+    eventsUrl: string;
+    /** Caller-authenticated telemetry request port, supplied by the host. */
+    request?: RunnableRequest;
+    createRun?: never;
+} | {
+    transport: 'in-process';
+    createRun(options: RunEmitterOptions): Promise<RunHandle>;
+    eventsUrl?: never;
+    request?: never;
+};
+export interface RunnableStateSnapshot {
+    activeRuns: RunStateSnapshot[];
+    runCount: number;
+}
+/**
+ * App-owned persistence/cache boundary. Runnable owns lifecycle orchestration;
+ * the host owns where its run state is stored.
+ */
+export interface RunnableStateHostContext {
+    state: GenericRunStateManager;
+    hydrateOnce(): Promise<void>;
+    /** Durable records in the host’s existing generic_runs store. Required by runRecorded/runs. */
+    records?: RunnableRecords;
+    /** Complete persisted telemetry, authorized by the same scope as records. */
+    telemetry?: RunnableTelemetryRecords;
+    /** Owner-authorized reads; producer memo identity remains a separate records contract. */
+    reads?: RunnableReadHost;
+    /** Includes original native/legacy tracked rows without inventing task outcomes. */
+    tracking?: RunnableTrackingHost;
+}
+//# sourceMappingURL=host.d.ts.map

package/dist/schemas/contracts/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../../src/schemas/contracts/host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAC7F,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,KAAK,EAAE,eAAe,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEpH,uFAAuF;AACvF,MAAM,MAAM,mBAAmB,GAC5B;IACD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,SAAS,CAAC,EAAE,KAAK,CAAC;CAClB,GACC;IACD,SAAS,EAAE,YAAY,CAAC;IACxB,SAAS,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC1D,SAAS,CAAC,EAAE,KAAK,CAAC;IAClB,OAAO,CAAC,EAAE,KAAK,CAAC;CAChB,CAAC;AAEH,MAAM,WAAW,qBAAqB;IACrC,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACxC,KAAK,EAAE,sBAAsB,CAAC;IAC9B,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,+FAA+F;IAC/F,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,6EAA6E;IAC7E,SAAS,CAAC,EAAE,wBAAwB,CAAC;IACrC,0FAA0F;IAC1F,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,oBAAoB,CAAC;CAChC"}

package/dist/schemas/contracts/host.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=host.js.map

package/dist/schemas/contracts/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../../../src/schemas/contracts/host.ts"],"names":[],"mappings":""}

package/dist/schemas/contracts/index.d.ts

@@ -0,0 +1,77 @@
+import type { RunnableImplementation } from "./execution.ts";
+import type { RunEmitterOptions } from "./runner.ts";
+import * as z from "zod/v4";
+import type { RuntimeDescriptor, KindContext, RuntimeRef } from "@vibesdotdev/kernel";
+import { type JsonObject, type JsonValue } from "@vibesdotdev/kernel/schemas/json";
+import type { Outcome } from "../outcome.ts";
+import type { GenericWrite } from "../writes.ts";
+export type RunnableKindContext = {
+    descriptor: RuntimeDescriptor;
+    context: KindContext;
+};
+export interface IngestMappingContext {
+    /** Run id; events without a run_id are rejected at ingest before reaching the mapping. */
+    runId: string;
+    /** Server-side timestamp (ms since epoch) used when the event omits one. */
+    receivedAt: number;
+}
+export type { RunMetricWrite, RunLogWrite, RunArtifactWrite, RunLifecycleUpdate, GenericWrite } from '../writes.ts';
+export interface IngestMapper {
+    /**
+     * Convert one telemetry event into zero or more generic writes.
+     *
+     * Pure: must not call out to a DB, network, or filesystem. All
+     * persistence happens in the host after collecting writes from this
+     * mapping plus any cross-cutting hooks.
+     */
+    (event: {
+        type: string;
+    } & JsonObject, ctx: IngestMappingContext): GenericWrite[];
+}
+/** Public recorded-client contracts share the existing Runnable owner. */
+export type NativeOwner = Pick<RunnableImplementation, 'observe' | 'subscribeObservation' | 'controls' | 'control'>;
+export type RunnableClientCreateRunOptions = RunEmitterOptions;
+export declare const RunnableRunOptionsSchema: z.ZodObject<{
+    signal: z.ZodOptional<z.ZodInstanceOf<AbortSignal>>;
+    parentRunId: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodType<JsonObject, JsonObject, z.core.$ZodTypeInternals<JsonObject, JsonObject>>>;
+    about: z.ZodOptional<z.ZodType<JsonValue, JsonValue, z.core.$ZodTypeInternals<JsonValue, JsonValue>>>;
+    configUnit: z.ZodOptional<z.ZodString>;
+    memoIdentity: z.ZodOptional<z.ZodObject<{
+        scope: z.ZodString;
+        runnableRevision: z.ZodString;
+        contextRevision: z.ZodString;
+    }, z.core.$strip>>;
+    memoUnits: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type RunnableRunOptions = z.infer<typeof RunnableRunOptionsSchema>;
+export type RecordedOutcome<T = JsonValue> = {
+    runId: string;
+    outcome: Outcome<T>;
+};
+export declare const RunnableVisualizationSelectionSchema: z.ZodObject<{
+    type: z.ZodString;
+    runnableId: z.ZodOptional<z.ZodString>;
+    reportedTelemetry: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const RunnableVisualizationQuerySchema: z.ZodUnion<readonly [z.ZodObject<{
+    runId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodString;
+    runnableId: z.ZodOptional<z.ZodString>;
+    reportedTelemetry: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>]>;
+export type RunnableVisualizationSelection = z.infer<typeof RunnableVisualizationSelectionSchema>;
+export type RunnableVisualizationQuery = z.infer<typeof RunnableVisualizationQuerySchema>;
+export type RunnableClientRuntime = Pick<RuntimeRef, 'hasKind' | 'query'>;
+export type { RunnableWatchOptions } from '../runs.ts';
+export * from './events.ts';
+export * from './host.ts';
+export * from './invocation.ts';
+export * from './state.ts';
+export * from './storage.ts';
+export * from './test-scenario.ts';
+export * from './watch.ts';
+export * from './execution.ts';
+export * from './runner.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/schemas/contracts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/schemas/contracts/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtF,OAAO,EAAqC,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,kCAAkC,CAAC;AACtH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,MAAM,MAAM,mBAAmB,GAAG;IAC9B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,OAAO,EAAE,WAAW,CAAC;CACxB,CAAC;AAQF,MAAM,WAAW,oBAAoB;IACjC,0FAA0F;IAC1F,KAAK,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC;CACtB;AACD,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACpH,MAAM,WAAW,YAAY;IACzB;;;;;;OAMG;IACH,CAAC,KAAK,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;KAChB,GAAG,UAAU,EAAE,GAAG,EAAE,oBAAoB,GAAG,YAAY,EAAE,CAAC;CAC9D;AACD,0EAA0E;AAC1E,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,sBAAsB,EAAE,SAAS,GAAG,sBAAsB,GAAG,UAAU,GAAG,SAAS,CAAC,CAAC;AACpH,MAAM,MAAM,8BAA8B,GAAG,iBAAiB,CAAC;AAC/D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;iBAQnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,eAAe,CAAC,CAAC,GAAG,SAAS,IAAI;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CACvB,CAAC;AACF,eAAO,MAAM,oCAAoC;;;;iBAE/C,CAAC;AACH,eAAO,MAAM,gCAAgC;;;;;;mBAE3C,CAAC;AACH,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,CAAC;AAClG,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAC1F,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,CAAC;AAC1E,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvD,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}

package/dist/schemas/contracts/index.js

@@ -0,0 +1,28 @@
+import * as z from "zod/v4";
+import { JsonValueSchema, JsonObjectSchema } from "@vibesdotdev/kernel/schemas/json";
+import { MemoIdentitySchema } from "../runs.js";
+export const RunnableRunOptionsSchema = z.object({
+    signal: z.instanceof(AbortSignal).optional(),
+    parentRunId: z.string().optional(),
+    metadata: JsonObjectSchema.optional(),
+    about: JsonValueSchema.optional(),
+    configUnit: z.string().optional(),
+    memoIdentity: MemoIdentitySchema.optional(),
+    memoUnits: z.array(z.string()).optional()
+});
+export const RunnableVisualizationSelectionSchema = z.object({
+    type: z.string(), runnableId: z.string().optional(), reportedTelemetry: z.array(z.string()).optional()
+});
+export const RunnableVisualizationQuerySchema = z.union([
+    z.object({ runId: z.string() }), RunnableVisualizationSelectionSchema
+]);
+export * from "./events.js";
+export * from "./host.js";
+export * from "./invocation.js";
+export * from "./state.js";
+export * from "./storage.js";
+export * from "./test-scenario.js";
+export * from "./watch.js";
+export * from "./execution.js";
+export * from "./runner.js";
+//# sourceMappingURL=index.js.map

package/dist/schemas/contracts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/schemas/contracts/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAmC,MAAM,kCAAkC,CAAC;AAEtH,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAmChD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE;IAC5C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,QAAQ,EAAE,gBAAgB,CAAC,QAAQ,EAAE;IACrC,KAAK,EAAE,eAAe,CAAC,QAAQ,EAAE;IACjC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,YAAY,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IAC3C,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC5C,CAAC,CAAC;AAMH,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,CAAC,MAAM,CAAC;IACzD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACzG,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC;IACpD,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,oCAAoC;CACxE,CAAC,CAAC;AAKH,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}

package/dist/schemas/contracts/invocation.d.ts

@@ -0,0 +1,9 @@
+import * as z from "zod/v4";
+/** Live owner context; the signal is never serialized into a queued request or run record. */
+export declare const RunnableInvocationSchema: z.ZodObject<{
+    runId: z.ZodOptional<z.ZodString>;
+    configUnit: z.ZodOptional<z.ZodString>;
+    signal: z.ZodOptional<z.ZodInstanceOf<AbortSignal>>;
+}, z.core.$strict>;
+export type RunnableInvocation = z.infer<typeof RunnableInvocationSchema>;
+//# sourceMappingURL=invocation.d.ts.map

package/dist/schemas/contracts/invocation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocation.d.ts","sourceRoot":"","sources":["../../../src/schemas/contracts/invocation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,8FAA8F;AAC9F,eAAO,MAAM,wBAAwB;;;;kBAInC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/schemas/contracts/invocation.js

@@ -0,0 +1,8 @@
+import * as z from "zod/v4";
+/** Live owner context; the signal is never serialized into a queued request or run record. */
+export const RunnableInvocationSchema = z.strictObject({
+    runId: z.string().min(1).optional(),
+    configUnit: z.string().min(1).optional(),
+    signal: z.instanceof(AbortSignal).optional()
+});
+//# sourceMappingURL=invocation.js.map

package/dist/schemas/contracts/invocation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocation.js","sourceRoot":"","sources":["../../../src/schemas/contracts/invocation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,8FAA8F;AAC9F,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,YAAY,CAAC;IACtD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACnC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACxC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE;CAC5C,CAAC,CAAC"}

package/dist/schemas/contracts/runner.d.ts

@@ -0,0 +1,61 @@
+import * as z from "zod/v4";
+import type { JsonObject, JsonValue } from "@vibesdotdev/kernel/schemas/json";
+/** Host-owned HTTP port; authentication is resolved per request by the host owner. */
+export type RunnableRequest = (url: string, options: RequestInit) => Promise<Response>;
+/** Producer options; the selected host supplies transport and lifecycle. */
+export interface RunEmitterOptions {
+    /** Actual native execution admission; this restricts lifecycle projection, never grants authority. */
+    executionGeneration?: number;
+    executionAttempt?: number;
+    runId?: string;
+    name?: string;
+    type?: string;
+    retryMax?: number;
+    retryBaseMs?: number;
+    retryMaxMs?: number;
+}
+interface RunnerLifetimeOptions extends RunEmitterOptions {
+    /** Retry waits belong to the caller's existing runtime lifecycle; once its signal aborts, retries stop. */
+    lifecycle: {
+        delay(ms: number, signal?: AbortSignal): Promise<void>;
+        readonly signal?: AbortSignal;
+    };
+}
+/** Direct hosts consume the same generated event batches without a synthetic HTTP endpoint. */
+export type RunnableEventDispatch = (events: JsonObject[]) => Promise<void>;
+export type RunnerOptions = RunnerLifetimeOptions & ({
+    url: string;
+    request?: RunnableRequest;
+    dispatch?: never;
+} | {
+    dispatch: RunnableEventDispatch;
+    url?: never;
+    request?: never;
+});
+export declare const RunEventOccurrenceSchema: z.ZodObject<{
+    eventId: z.ZodString;
+    timestamp: z.ZodNumber;
+}, z.core.$strict>;
+export type RunEventOccurrence = z.infer<typeof RunEventOccurrenceSchema>;
+export interface RunHandle {
+    readonly runId: string;
+    start(config?: JsonObject): Promise<void>;
+    metric(key: string, value: number, dimensions?: JsonObject): Promise<void>;
+    log(level: 'debug' | 'info' | 'warn' | 'error', message: string, data?: JsonValue): Promise<void>;
+    status(status: string, message?: string): Promise<void>;
+    progress(fraction: number, message?: string): Promise<void>;
+    artifact(name: string, mimeType?: string, data?: string): Promise<void>;
+    /**
+     * Emit an arch-specific event. The host's ingest mapping (resolved by
+     * `runnable_type`) translates the event into generic writes; producers
+     * that need typed event shapes (e.g. `training.step`,
+     * `benchmark.scenario.completed`, `model.downloaded`) call this rather
+     * than overloading metric/log.
+     */
+    event(type: string, payload?: JsonObject, occurrence?: RunEventOccurrence): Promise<void>;
+    done(opts?: {
+        summary?: JsonObject;
+    }): Promise<void>;
+}
+export {};
+//# sourceMappingURL=runner.d.ts.map

package/dist/schemas/contracts/runner.d.ts.map

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

package/dist/schemas/contracts/runner.js

@@ -0,0 +1,3 @@
+import * as z from "zod/v4";
+export const RunEventOccurrenceSchema = z.strictObject({ eventId: z.string().min(1), timestamp: z.number() });
+//# sourceMappingURL=runner.js.map

package/dist/schemas/contracts/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../../src/schemas/contracts/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAkC5B,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC"}

package/dist/schemas/contracts/state.d.ts

@@ -0,0 +1,147 @@
+import type { RunRecord } from '../runs.ts';
+import * as z from "zod/v4";
+import type { GenericWrite } from "./index.ts";
+import type { TieredTimeSeries } from "../../runtime/state/index.ts";
+/**
+ * Generic in-memory run state types.
+ *
+ * Runtime-agnostic shape for tracking active and recent runs in RAM.
+ * Each run carries lifecycle metadata, a per-key tiered metric series,
+ * a bounded log ring, and an artifact counter — no arch-specific
+ * fields. Arch-flavored projections (CGN passes, Lila states, etc.)
+ * live in the corresponding arch package's projection client.
+ *
+ * The host (apps/runnable-web) implements `GenericRunStateManager`
+ * against this shape and feeds it from the same `dispatchEvent`
+ * pipeline that writes to `generic_runs`/`run_metrics`/`run_logs`/
+ * `run_artifacts` — so the RAM cache and the DB stay in lockstep.
+ */
+export interface TierSpec {
+    intervalMs: number;
+    maxPoints: number;
+}
+export interface TieredBucket<T> {
+    ts: number;
+    count: number;
+    sum: Record<string, number>;
+    last: T;
+}
+export interface DataPoint {
+    ts: number;
+    value: Record<string, number>;
+    count: number;
+}
+export interface TierStats {
+    intervalMs: number;
+    count: number;
+    maxPoints: number;
+}
+export interface SeriesStats {
+    tiers: TierStats[];
+    totalPoints: number;
+}
+export interface AccumState<T> {
+    sum: Record<string, number>;
+    count: number;
+    last: T;
+}
+export declare const RUN_STATUS_VALUES: readonly ["idle", "loading", "running", "paused", "stopping", "stopped", "error", "completed"];
+export type KnownRunStatus = (typeof RUN_STATUS_VALUES)[number];
+export type RunStatus = KnownRunStatus | (string & {});
+export interface RunLogEntry {
+    ts: number;
+    level: "debug" | "info" | "warn" | "error";
+    message: string;
+    data?: unknown;
+}
+export interface MetricSeriesPoint {
+    ts: number;
+    value: number;
+}
+export interface MetricSeriesSnapshot {
+    key: string;
+    values: MetricSeriesPoint[];
+}
+/**
+ * Live, mutable per-run state held by the host's RAM cache. Owns
+ * tiered metric series and a bounded log ring; arch-shaped data
+ * (passes, frames, heal events, etc.) is NOT here — consumers fetch
+ * those through the arch's projection client.
+ */
+export interface RunStateEntry {
+    activity?: RunRecord['activity'];
+    id: string;
+    runnableType: string;
+    runnableId: string;
+    name: string;
+    status: string;
+    startedAt: number;
+    endedAt: number | null;
+    lastEventAt: number;
+    progress: number;
+    config: RunStatePayload;
+    metadata: RunStatePayload;
+    metrics: Map<string, TieredTimeSeries<{
+        value: number;
+    }>>;
+    logs: RunLogEntry[];
+    artifactCount: number;
+    done: boolean;
+}
+export declare const RunStatePayloadSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+export type RunStatePayload = z.infer<typeof RunStatePayloadSchema>;
+/** Serialized form of `RunStateEntry` for SSE / API responses. */
+export interface RunStateSnapshot {
+    activity?: RunRecord['activity'];
+    id: string;
+    runnableType: string;
+    runnableId: string;
+    name: string;
+    status: string;
+    startedAt: number;
+    endedAt: number | null;
+    lastEventAt: number;
+    progress: number;
+    config: RunStatePayload;
+    metadata: RunStatePayload;
+    metrics: Record<string, MetricSeriesSnapshot>;
+    logs: RunLogEntry[];
+    artifactCount: number;
+    done: boolean;
+}
+export interface RunStateListEntry {
+    id: string;
+    state: RunStateSnapshot;
+    active: boolean;
+}
+export interface RecordStartFields {
+    runId: string;
+    runnableType: string;
+    runnableId?: string;
+    name?: string;
+    config?: RunStatePayload;
+    metadata?: RunStatePayload;
+    startedAt?: number;
+    status?: string;
+}
+/**
+ * Host-side cache that mirrors generic_runs in RAM for the SSE
+ * snapshot. Implementations must remain runtime-agnostic.
+ */
+export interface GenericRunStateManager {
+    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;
+    readonly runCount: number;
+}
+export type MetricSample = {
+    value: number;
+};
+//# sourceMappingURL=state.d.ts.map

package/dist/schemas/contracts/state.d.ts.map

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

package/dist/schemas/contracts/state.js

@@ -0,0 +1,16 @@
+import * as z from "zod/v4";
+// ──────────────────────────────────────────────
+// Run state entry / snapshot
+// ──────────────────────────────────────────────
+export const RUN_STATUS_VALUES = [
+    'idle',
+    'loading',
+    'running',
+    'paused',
+    'stopping',
+    'stopped',
+    'error',
+    'completed',
+];
+export const RunStatePayloadSchema = z.record(z.string(), z.unknown());
+//# sourceMappingURL=state.js.map

package/dist/schemas/contracts/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/schemas/contracts/state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AA0D5B,iDAAiD;AACjD,6BAA6B;AAC7B,iDAAiD;AAEjD,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAChC,MAAM;IACN,SAAS;IACT,SAAS;IACT,QAAQ;IACR,UAAU;IACV,SAAS;IACT,OAAO;IACP,WAAW;CACF,CAAC;AAgDX,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC"}