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

package/dist/schemas/runs.d.ts.map

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

package/dist/schemas/runs.js

@@ -0,0 +1,163 @@
+import * as z from 'zod/v4';
+import { RuntimeActorSchema, RuntimeInvokeWorkspaceSchema } from '@vibesdotdev/kernel/schemas/scope';
+import { JsonObjectSchema, JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+import { OutcomeSchema } from "./outcome.js";
+import { RunActivitySchema, RunMetricWriteSchema, RunLogWriteSchema, RunArtifactWriteSchema } from "./writes.js";
+import { RawRunSchema } from "./projection.js";
+import { RunContextSchema, RunObservationSchema } from "./context.js";
+import { RunnableDescriptorSchema } from "./descriptors.js";
+/** Neutral execution evidence; the scheduling owner decides when another admission is allowed. */
+export const RunnableAttemptSchema = z.object({
+    attempt: z.number().int().positive(), revision: z.number().int().nonnegative(),
+    jobId: z.string().nullable(), outcome: OutcomeSchema
+});
+export const RunnableAttemptFeedbackSchema = z.object({
+    attempt: z.number().int().positive(), retry: z.number().int().nonnegative(),
+    steering: z.number().int().nonnegative(), previous: OutcomeSchema.nullable(),
+    history: z.array(RunnableAttemptSchema)
+});
+/** Portable admission facts only; no principal, bearer or session credentials. */
+export const RunAdmissionSchema = z.object({
+    actor: RuntimeActorSchema.omit({ sessionId: true, participantId: true, harnessSessionId: true }).optional(),
+    workspace: RuntimeInvokeWorkspaceSchema.omit({ sessionId: true }).optional()
+});
+/** The selected owner admitted this exact portable config before memo or queued dispatch. */
+export const RunnableExecutionOwnerSchema = z.strictObject({
+    kind: z.enum(['runnable/runnable', 'runnable/executor']), id: z.string().min(1)
+});
+export const RunnableInputAdmissionSchema = z.strictObject({
+    version: z.literal(1), runId: z.string().min(1), runnableId: z.string().min(1),
+    /** Actual live enclosing invocation; explicit presentation lineage cannot replace this fact. */
+    enclosingRunId: z.string().min(1).optional(),
+    inputDigest: z.string().min(1), configDigest: z.string().min(1),
+    owner: RunnableExecutionOwnerSchema,
+    context: JsonObjectSchema.optional()
+});
+export const MemoIdentitySchema = z.object({ scope: z.string().min(1), runnableRevision: z.string().min(1), contextRevision: z.string().min(1) });
+/** Owner-published references point to the execution records that already exist. */
+export const RunExecutionReferenceSchema = z.strictObject({
+    jobId: z.string().min(1).optional(),
+    aiCallRunId: z.string().min(1).optional(),
+    ciRunId: z.string().min(1).optional(),
+    executionReference: z.string().min(1).optional()
+}).refine((reference) => Object.keys(reference).length > 0, { message: 'An execution reference is required.' });
+export const RUN_EXECUTION_REFERENCE_EVENT = 'runnable.execution.reference';
+/** Drops a producer job id when the queue never admitted the run. */
+export const RunExecutionReferenceReleaseSchema = z.strictObject({
+    released: z.literal(true)
+});
+export const RUN_EXECUTION_REFERENCE_RELEASE = { released: true };
+/** A native scheduling owner supplies its existing stable execution and physical attempt. */
+export const RunnableNativeExecutionSchema = z.strictObject({
+    id: z.string().min(1), reference: RunExecutionReferenceSchema,
+    owner: JsonObjectSchema, generation: z.number().int().nonnegative(),
+    result: z.strictObject({ mode: RunnableDescriptorSchema.shape.nativeResult.unwrap(), path: z.string().min(1).optional() }),
+    attempt: z.number().int().positive(), maxAttempts: z.number().int().positive()
+});
+export const RunnablePhysicalAttemptSchema = RunnableNativeExecutionSchema.pick({ generation: true, attempt: true, maxAttempts: true }).extend({
+    startedAt: z.number(), endedAt: z.number().optional(), outcome: OutcomeSchema.optional()
+});
+export const RunnableNativeExecutionStateSchema = RunnableNativeExecutionSchema.pick({ id: true, owner: true, generation: true, reference: true, result: true }).extend({
+    /** Captured selected implementation, distinct from the physical scheduling owner. */
+    observer: RunnableExecutionOwnerSchema.optional(),
+    attempts: z.array(RunnablePhysicalAttemptSchema)
+});
+export const RUN_NATIVE_EXECUTION_METADATA_KEY = 'runnable.nativeExecution';
+export const RUN_NATIVE_COMPLETION_METADATA_KEY = 'runnable.nativeCompletion';
+export const RunnableResultModeSchema = RunnableDescriptorSchema.shape.nativeResult.unwrap();
+export function pinnedRunResultMode(metadata) {
+    const record = JsonObjectSchema.safeParse(metadata);
+    const native = record.success ? JsonObjectSchema.safeParse(record.data[RUN_NATIVE_EXECUTION_METADATA_KEY]) : undefined;
+    const result = native?.success ? JsonObjectSchema.safeParse(native.data.result) : undefined;
+    const mode = result?.success ? RunnableResultModeSchema.safeParse(result.data.mode) : undefined;
+    return mode?.success ? mode.data : undefined;
+}
+/** Read-only facts projected by the selected native execution owner from its durable receipt. */
+export const RunnableNativeObservationSchema = z.strictObject({
+    status: z.string().min(1), terminal: z.boolean(), generation: z.number().int().nonnegative(), receipt: JsonObjectSchema, receiptId: z.string().min(1),
+    outcome: OutcomeSchema.optional(), progress: z.number().optional(), endedAt: z.number().optional()
+});
+/** Published by the approval-owning executor after observing the central tool pipeline receipt. */
+export const RunApprovalSchema = z.enum(['approved', 'assumed']);
+export const RunApprovalEventSchema = z.strictObject({ approval: RunApprovalSchema });
+export const RUN_APPROVAL_EVENT = 'runnable.approval.observed';
+export const RunRecordSchema = z.object({
+    id: z.string().min(1), scope: z.string().min(1), status: z.string(), runnableType: z.string(), runnableId: z.string(), config: JsonObjectSchema,
+    name: RawRunSchema.shape.name,
+    progress: z.number(), startedAt: z.number(), endedAt: z.number().optional(), metadata: JsonObjectSchema,
+    parentRunId: z.string().optional(), outcome: OutcomeSchema.optional(), inputDigest: z.string(),
+    ref: RunExecutionReferenceSchema.optional(),
+    rankReason: z.union([z.object({ named: z.literal(true) }), z.object({ coldStart: z.literal(true), cost: z.number() })]).optional(),
+    approval: RunApprovalSchema.optional(), activity: RunActivitySchema.optional()
+});
+/** Tracking includes native legacy runs; absent task evidence remains absent. */
+export const RunnableTrackedRunSchema = RawRunSchema.extend({
+    runnableId: z.string(), endedAt: z.number().nullish(), hostId: z.string().optional(),
+    scope: RunRecordSchema.shape.scope.optional(), inputDigest: RunRecordSchema.shape.inputDigest.optional(),
+    parentRunId: RunRecordSchema.shape.parentRunId, outcome: RunRecordSchema.shape.outcome,
+    resultMode: RunnableResultModeSchema.optional(),
+    ref: RunRecordSchema.shape.ref, rankReason: RunRecordSchema.shape.rankReason, approval: RunRecordSchema.shape.approval,
+    activity: RunRecordSchema.shape.activity, context: RunContextSchema.optional()
+});
+/** Task disposition only; result values, claims and failure evidence stay on the selected snapshot. */
+export const RunnableCatalogOutcomeSchema = z.discriminatedUnion('status', [
+    OutcomeSchema.options[0].pick({ status: true }),
+    OutcomeSchema.options[1].pick({ status: true, reason: true }),
+    OutcomeSchema.options[2].pick({ status: true, why: true }),
+    OutcomeSchema.options[3].pick({ status: true, reason: true })
+]);
+/** List identity/state only. Omitted evidence is unrequested, never represented as empty record data. */
+export const RunnableCatalogRunSchema = RunnableTrackedRunSchema.omit({ config: true, metadata: true, outcome: true })
+    .extend({ outcome: RunnableCatalogOutcomeSchema.optional(), observation: RunObservationSchema.optional() });
+export const RunnableCatalogSnapshotSchema = z.object({ run: RunnableCatalogRunSchema, children: z.array(RunnableCatalogRunSchema) });
+export const RunnableCatalogWatchSnapshotSchema = z.object({ runs: z.array(RunnableCatalogSnapshotSchema), revision: z.number().int().positive() });
+/** Complete persisted telemetry; presentation does not reconstruct history from bounded RAM tails. */
+export const RunnableTelemetrySnapshotSchema = z.object({
+    metrics: z.array(RunMetricWriteSchema), logs: z.array(RunLogWriteSchema), artifacts: z.array(RunArtifactWriteSchema)
+});
+export const RunnableSnapshotSchema = RunnableTelemetrySnapshotSchema.extend({ run: RunnableTrackedRunSchema, children: z.array(RunnableTrackedRunSchema), observation: RunObservationSchema.optional() });
+export const RunQuerySchema = z.object({ scope: z.string().min(1), id: z.string().min(1).optional(), runnable: z.string().optional(), parentRunId: z.string().optional(), status: z.enum(['done', 'not-done', 'disputed', 'skipped']).optional(), inputDigest: z.string().optional(), since: z.number().optional() });
+export const RunnableReadQuerySchema = RunQuerySchema.omit({ scope: true }).extend({
+    type: z.string().min(1).optional(), under: z.string().min(1).optional(),
+    host: z.string().min(1).optional(), input: JsonValueSchema.optional(), about: JsonValueSchema.optional()
+});
+export const RunnableWatchSnapshotSchema = z.object({ runs: z.array(RunnableSnapshotSchema), revision: z.number().int().positive() });
+/** Native lifetime options; transports carry the error handler as a positional callback. */
+export const RunnableWatchErrorHandlerSchema = z.custom(value => value instanceof Function);
+/** Records retains full record payloads; snapshot also reads persisted telemetry. */
+export const RunnableWatchProjectionSchema = z.enum(['snapshot', 'records']);
+export const RunnableWatchOptionsSchema = z.object({
+    signal: z.instanceof(AbortSignal).optional(),
+    onError: RunnableWatchErrorHandlerSchema.optional(),
+    projection: RunnableWatchProjectionSchema.optional()
+});
+export const RunnableWatchArgumentSchema = z.union([
+    RunnableWatchErrorHandlerSchema.transform(onError => ({ onError })),
+    RunnableWatchOptionsSchema
+]).default({});
+/** Terminal invocation facts, emitted only after the record is persisted. */
+export const RunCompletedPayloadSchema = z.strictObject({
+    runId: z.string().min(1),
+    occurrenceId: z.string().min(1).optional(),
+    generation: z.number().int().nonnegative().optional(),
+    attempt: z.number().int().positive().optional(),
+    runnableId: z.string().min(1),
+    status: z.string().min(1),
+    outcome: OutcomeSchema,
+    parentRunId: z.string().min(1).optional()
+});
+export const RUN_COMPLETED_EVENT = 'runnable.run.completed';
+/** Persist the original completion occurrence before delivery; reentry resends these same bytes. */
+export const RunnableNativeCompletionSchema = z.strictObject({
+    receiptId: z.string().min(1), eventId: z.string().min(1), timestamp: z.number(),
+    /** Historical pending receipts may predate generation capture; unknown remains absent. */
+    generation: z.number().int().nonnegative().optional(),
+    attempt: z.number().int().positive().optional(),
+    payload: RunCompletedPayloadSchema, delivered: z.boolean()
+});
+/** The existing record retains older pending occurrences across later Job admissions. */
+export const RunnableNativeCompletionOutboxSchema = z.union([
+    z.array(RunnableNativeCompletionSchema),
+    RunnableNativeCompletionSchema.transform(completion => [completion])
+]);
+//# sourceMappingURL=runs.js.map

package/dist/schemas/runs.js.map

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

package/dist/schemas/writes.d.ts

@@ -0,0 +1,103 @@
+import * as z from 'zod/v4';
+/** The execution owner's latest public description, with its evidence time. */
+export declare const RunActivitySchema: z.ZodObject<{
+    message: z.ZodString;
+    ts: z.ZodNumber;
+}, z.core.$strip>;
+export declare const RunMetricWriteSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"metric">;
+    key: z.ZodString;
+    value: z.ZodNumber;
+    ts: z.ZodNumber;
+    dimensions: z.ZodOptional<z.ZodType<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject>>>;
+}, z.core.$strip>;
+export declare const RunLogWriteSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"log">;
+    level: z.ZodEnum<{
+        error: "error";
+        info: "info";
+        warn: "warn";
+        debug: "debug";
+    }>;
+    message: z.ZodString;
+    ts: z.ZodNumber;
+    data: z.ZodOptional<z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>;
+}, z.core.$strip>;
+export declare const RunArtifactWriteSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"artifact">;
+    id: z.ZodString;
+    artifactKind: z.ZodString;
+    name: z.ZodString;
+    mimeType: z.ZodString;
+    ts: z.ZodNumber;
+    version: z.ZodOptional<z.ZodString>;
+    sequenceNo: z.ZodOptional<z.ZodNumber>;
+    hash: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodNumber>;
+    path: z.ZodOptional<z.ZodString>;
+    data: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodType<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject>>>;
+}, z.core.$strip>;
+export declare const RunLifecycleUpdateSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"lifecycle">;
+    patch: z.ZodObject<{
+        status: z.ZodOptional<z.ZodString>;
+        progress: z.ZodOptional<z.ZodNumber>;
+        endedAt: z.ZodOptional<z.ZodNumber>;
+        metadata: z.ZodOptional<z.ZodType<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject>>>;
+        activity: z.ZodOptional<z.ZodObject<{
+            message: z.ZodString;
+            ts: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const GenericWriteSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"metric">;
+    key: z.ZodString;
+    value: z.ZodNumber;
+    ts: z.ZodNumber;
+    dimensions: z.ZodOptional<z.ZodType<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject>>>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"log">;
+    level: z.ZodEnum<{
+        error: "error";
+        info: "info";
+        warn: "warn";
+        debug: "debug";
+    }>;
+    message: z.ZodString;
+    ts: z.ZodNumber;
+    data: z.ZodOptional<z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"artifact">;
+    id: z.ZodString;
+    artifactKind: z.ZodString;
+    name: z.ZodString;
+    mimeType: z.ZodString;
+    ts: z.ZodNumber;
+    version: z.ZodOptional<z.ZodString>;
+    sequenceNo: z.ZodOptional<z.ZodNumber>;
+    hash: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodNumber>;
+    path: z.ZodOptional<z.ZodString>;
+    data: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodType<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject>>>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"lifecycle">;
+    patch: z.ZodObject<{
+        status: z.ZodOptional<z.ZodString>;
+        progress: z.ZodOptional<z.ZodNumber>;
+        endedAt: z.ZodOptional<z.ZodNumber>;
+        metadata: z.ZodOptional<z.ZodType<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject>>>;
+        activity: z.ZodOptional<z.ZodObject<{
+            message: z.ZodString;
+            ts: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "kind">;
+export type RunMetricWrite = z.infer<typeof RunMetricWriteSchema>;
+export type RunLogWrite = z.infer<typeof RunLogWriteSchema>;
+export type RunArtifactWrite = z.infer<typeof RunArtifactWriteSchema>;
+export type RunLifecycleUpdate = z.infer<typeof RunLifecycleUpdateSchema>;
+export type GenericWrite = z.infer<typeof GenericWriteSchema>;
+//# sourceMappingURL=writes.d.ts.map

package/dist/schemas/writes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writes.d.ts","sourceRoot":"","sources":["../../src/schemas/writes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,+EAA+E;AAC/E,eAAO,MAAM,iBAAiB;;;iBAAkE,CAAC;AAEjG,eAAO,MAAM,oBAAoB;;;;;;iBAG/B,CAAC;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;iBAG5B,CAAC;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;iBAKjC,CAAC;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;iBAKnC,CAAC;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAE7B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/schemas/writes.js

@@ -0,0 +1,28 @@
+import * as z from 'zod/v4';
+import { JsonObjectSchema, JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+/** The execution owner's latest public description, with its evidence time. */
+export const RunActivitySchema = z.object({ message: z.string().trim().min(1), ts: z.number() });
+export const RunMetricWriteSchema = z.object({
+    kind: z.literal('metric'), key: z.string(), value: z.number(), ts: z.number(),
+    dimensions: JsonObjectSchema.optional()
+});
+export const RunLogWriteSchema = z.object({
+    kind: z.literal('log'), level: z.enum(['debug', 'info', 'warn', 'error']),
+    message: z.string(), ts: z.number(), data: JsonValueSchema.optional()
+});
+export const RunArtifactWriteSchema = z.object({
+    kind: z.literal('artifact'), id: z.string(), artifactKind: z.string(), name: z.string(),
+    mimeType: z.string(), ts: z.number(), version: z.string().optional(),
+    sequenceNo: z.number().optional(), hash: z.string().optional(), size: z.number().optional(),
+    path: z.string().optional(), data: z.string().optional(), metadata: JsonObjectSchema.optional()
+});
+export const RunLifecycleUpdateSchema = z.object({
+    kind: z.literal('lifecycle'), patch: z.object({
+        status: z.string().optional(), progress: z.number().optional(),
+        endedAt: z.number().optional(), metadata: JsonObjectSchema.optional(), activity: RunActivitySchema.optional()
+    })
+});
+export const GenericWriteSchema = z.discriminatedUnion('kind', [
+    RunMetricWriteSchema, RunLogWriteSchema, RunArtifactWriteSchema, RunLifecycleUpdateSchema
+]);
+//# sourceMappingURL=writes.js.map

package/dist/schemas/writes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writes.js","sourceRoot":"","sources":["../../src/schemas/writes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAErF,+EAA+E;AAC/E,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAEjG,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IAC7E,UAAU,EAAE,gBAAgB,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACzE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,eAAe,CAAC,QAAQ,EAAE;CACrE,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IACvF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3F,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,gBAAgB,CAAC,QAAQ,EAAE;CAC/F,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QAC7C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC9D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,gBAAgB,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,iBAAiB,CAAC,QAAQ,EAAE;KAC7G,CAAC;CACF,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAC9D,oBAAoB,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,wBAAwB;CACzF,CAAC,CAAC"}

package/dist/state.d.ts

@@ -0,0 +1,175 @@
+import type { RunRecord } from './schemas/runs.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.
+ */
+import * as z from 'zod/v4';
+import type { GenericWrite } from "./schemas/contracts.ts";
+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 declare const TIME_SERIES_TIERS: TierSpec[];
+export declare class TieredTimeSeries<T extends Record<string, number>> {
+    private readonly extractFields;
+    private readonly minIntervalMs;
+    private tiers;
+    private lastEmitTs;
+    private accum;
+    private readonly fields;
+    constructor(extractFields: (item: T) => Record<string, number>, minIntervalMs?: number);
+    push(item: T, ts?: number): void;
+    getAll(): DataPoint[];
+    getRecent(count: number): DataPoint[];
+    getRange(fromMs: number, toMs: number): DataPoint[];
+    size(): number;
+    stats(): SeriesStats;
+    clone(): TieredTimeSeries<T>;
+    clear(): void;
+    private flushBucket;
+    private insertIntoTiers;
+}
+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;
+}
+/** 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=state.d.ts.map

package/dist/state.d.ts.map

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