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

package/dist/schemas/descriptors.js

@@ -0,0 +1,125 @@
+import * as z from 'zod/v4';
+import { RuntimeDescriptorSchema } from '@vibesdotdev/kernel/schemas/descriptor';
+import { JsonObjectSchema } from '@vibesdotdev/kernel/schemas/json';
+import { EntityKindSchema } from '@vibesdotdev/shared/citations';
+import { RunnablePanelParametersSchema } from "./panels.js";
+import { RunContextBindingSchema, RunContextPathSchema } from "./context.js";
+// 1. runnable/type
+export const RunnableTypeDescriptorSchema = RuntimeDescriptorSchema.extend({
+    kind: z.literal('runnable/type'),
+    category: z.string().min(1),
+    parallelizable: z.boolean().optional(),
+    telemetry: z.array(z.string().min(1)).optional(),
+});
+export const RunnableRoleSchema = z.enum(['claims', 'read-claims', 'verify', 'sign-off', 'coordinate', 'reconcile', 'probe']);
+// 2. runnable/runnable
+export const RunnableDescriptorSchema = RuntimeDescriptorSchema.extend({
+    kind: z.literal('runnable/runnable'),
+    type: z.string(), // References a runnable/type ID
+    /** Explicit owner implementations can retain a type while bypassing its generic executor. */
+    execution: z.enum(['type', 'native']).default('type'),
+    settings: JsonObjectSchema.default({}),
+    nativeResult: z.enum(['value', 'outcome', 'void']).default('value'),
+    roles: z.array(RunnableRoleSchema).default([]),
+    entities: z.array(EntityKindSchema).optional(),
+    cost: z.number().nonnegative().default(0),
+    memo: z.boolean().default(false),
+    durable: z.boolean().optional(),
+    telemetry: z.array(z.string()).optional(),
+    backend: z.string().min(1).optional(),
+    capabilities: z.array(z.string()).optional(),
+});
+// 3. runnable/config
+export const RunnableConfigDescriptorSchema = RuntimeDescriptorSchema.extend({
+    kind: z.literal('runnable/config'),
+    schema: z.unknown().optional(), // Existing opaque schema definition or owner-resolved reference.
+    defaults: z.unknown().optional()
+});
+// 4. runnable/telemetry
+export const RunnableTelemetryDescriptorSchema = RuntimeDescriptorSchema.extend({
+    kind: z.literal('runnable/telemetry'),
+    runContext: RunContextBindingSchema.optional(),
+    events: z.array(z.object({
+        name: z.string(),
+        /** Display the owner's event meaning or its recorded message. */
+        summary: z.union([
+            z.strictObject({ message: RunContextPathSchema, label: z.string().min(1).optional() }),
+            z.strictObject({ text: z.string().min(1), label: z.string().min(1).optional() })
+        ]).optional(),
+        fields: z.array(z.object({
+            name: z.string(),
+            type: z.string()
+        }))
+    })),
+    metrics: z.array(z.object({
+        name: z.string(),
+        label: z.string(),
+        range: z.tuple([z.number(), z.number()]).optional()
+    }))
+});
+// 5. runnable/result
+export const RunnableResultDescriptorSchema = RuntimeDescriptorSchema.extend({
+    kind: z.literal('runnable/result'),
+    artifacts: z.array(z.string()),
+    metricsSchema: z.unknown().optional()
+});
+// 6. runnable/visualization
+export const RunnablePanelType = ['bar_chart', 'line_chart', 'heatmap', 'table', 'gauge', 'lattice'];
+export const RunnableVisualizationDescriptorSchema = RuntimeDescriptorSchema.extend({
+    kind: z.literal('runnable/visualization'),
+    telemetryId: z.string(), // References a runnable/telemetry ID
+    panelType: z.enum(RunnablePanelType).optional(),
+    componentRef: z.object({
+        id: z.uuid(),
+        version: z.string()
+    }).optional(),
+    componentParams: RunnablePanelParametersSchema.optional()
+}).superRefine((data, ctx) => {
+    const hasPanelType = data.panelType !== undefined;
+    const hasComponentRef = data.componentRef !== undefined;
+    if (hasPanelType && hasComponentRef) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'Must set exactly one of panelType or componentRef, not both',
+            path: ['panelType']
+        });
+    }
+    if (!hasPanelType && !hasComponentRef) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'Must set exactly one of panelType or componentRef',
+            path: ['panelType']
+        });
+    }
+});
+// 7. runnable/ingest-mapping
+//
+// Declares how an arch package translates its telemetry events into generic
+// writes against runnable-web's persistence (run_metrics / run_logs /
+// run_artifacts / run_alerts / generic_runs lifecycle updates). The descriptor
+// names the runnable type it serves and lists the event type names it covers;
+// the implementation (carried by the kind's `Implementation` class registered
+// via the runtime plugin) holds the actual `(event, ctx) => GenericWrite[]`
+// mapping function.
+//
+// This kind exists so apps/runnable-web's /api/events handler can dispatch
+// generically by `runnable_type`, never branching on a specific arch.
+export const RunnableIngestMappingDescriptorSchema = RuntimeDescriptorSchema.extend({
+    kind: z.literal('runnable/ingest-mapping'),
+    runnableType: z.string(), // References a runnable/type ID
+    eventTypes: z.array(z.string()), // Event type names this mapping handles
+});
+// 8. runnable/executor — owner-provided spawn planning for one runnable type.
+export const RunnableExecutorDescriptorSchema = RuntimeDescriptorSchema.extend({
+    kind: z.literal('runnable/executor'),
+    runnableType: z.string().min(1)
+});
+// 9. runnable/supervisor — runtime-local process lifecycle implementation.
+export const RunnableSupervisorDescriptorSchema = RuntimeDescriptorSchema.extend({
+    kind: z.literal('runnable/supervisor')
+});
+// 10. runnable/event-broker — runtime-local authenticated event fan-out.
+export const RunnableEventBrokerDescriptorSchema = RuntimeDescriptorSchema.extend({
+    kind: z.literal('runnable/event-broker')
+});
+//# sourceMappingURL=descriptors.js.map

package/dist/schemas/descriptors.js.map

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

package/dist/schemas/events.d.ts

@@ -0,0 +1,359 @@
+/** Shared core event protocol for HTTP and direct Runnable hosts. */
+import * as z from 'zod/v4';
+export declare const eventEnvelopeFields: {
+    run_id: z.ZodOptional<z.ZodString>;
+    event_id: z.ZodOptional<z.ZodString>;
+    execution_generation: z.ZodOptional<z.ZodNumber>;
+    execution_attempt: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+};
+export declare const startEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"start">;
+    runnable_type: z.ZodOptional<z.ZodString>;
+    runnable_id: z.ZodOptional<z.ZodString>;
+    host_id: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    config: 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>>>;
+    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>>>;
+    run_id: z.ZodOptional<z.ZodString>;
+    event_id: z.ZodOptional<z.ZodString>;
+    execution_generation: z.ZodOptional<z.ZodNumber>;
+    execution_attempt: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+}, z.core.$catchall<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>>>>;
+export declare const progressEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"progress">;
+    fraction: z.ZodNumber;
+    message: z.ZodOptional<z.ZodString>;
+    run_id: z.ZodOptional<z.ZodString>;
+    event_id: z.ZodOptional<z.ZodString>;
+    execution_generation: z.ZodOptional<z.ZodNumber>;
+    execution_attempt: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/** A current description without asserting a percentage or changing execution state. */
+export declare const activityEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"activity">;
+    message: z.ZodString;
+    run_id: z.ZodOptional<z.ZodString>;
+    event_id: z.ZodOptional<z.ZodString>;
+    execution_generation: z.ZodOptional<z.ZodNumber>;
+    execution_attempt: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const metricEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"metric">;
+    key: z.ZodString;
+    value: 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>>>;
+    run_id: z.ZodOptional<z.ZodString>;
+    event_id: z.ZodOptional<z.ZodString>;
+    execution_generation: z.ZodOptional<z.ZodNumber>;
+    execution_attempt: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const logEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"log">;
+    level: z.ZodEnum<{
+        error: "error";
+        info: "info";
+        warn: "warn";
+        debug: "debug";
+    }>;
+    message: z.ZodString;
+    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>>>;
+    run_id: z.ZodOptional<z.ZodString>;
+    event_id: z.ZodOptional<z.ZodString>;
+    execution_generation: z.ZodOptional<z.ZodNumber>;
+    execution_attempt: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const ArtifactDataEncodingSchema: z.ZodEnum<{
+    base64: "base64";
+    utf8: "utf8";
+}>;
+export declare const artifactEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"artifact">;
+    name: z.ZodString;
+    artifact_kind: z.ZodOptional<z.ZodString>;
+    encoding: z.ZodOptional<z.ZodEnum<{
+        base64: "base64";
+        utf8: "utf8";
+    }>>;
+    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>>>;
+    sequence_no: z.ZodOptional<z.ZodNumber>;
+    mime_type: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodNumber>;
+    data: z.ZodOptional<z.ZodString>;
+    run_id: z.ZodOptional<z.ZodString>;
+    event_id: z.ZodOptional<z.ZodString>;
+    execution_generation: z.ZodOptional<z.ZodNumber>;
+    execution_attempt: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const statusEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"status">;
+    status: z.ZodEnum<{
+        error: "error";
+        running: "running";
+        paused: "paused";
+        stopping: "stopping";
+        stopped: "stopped";
+        completed: "completed";
+    }>;
+    message: z.ZodOptional<z.ZodString>;
+    run_id: z.ZodOptional<z.ZodString>;
+    event_id: z.ZodOptional<z.ZodString>;
+    execution_generation: z.ZodOptional<z.ZodNumber>;
+    execution_attempt: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const doneEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"done">;
+    summary: 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>>>;
+    run_id: z.ZodOptional<z.ZodString>;
+    event_id: z.ZodOptional<z.ZodString>;
+    execution_generation: z.ZodOptional<z.ZodNumber>;
+    execution_attempt: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const CORE_EVENT_TYPES: readonly ["start", "progress", "activity", "metric", "log", "artifact", "status", "done"];
+export type CoreEventType = (typeof CORE_EVENT_TYPES)[number];
+export declare const CORE_EVENT_TYPE_SET: ReadonlySet<string>;
+export declare const coreEventDiscriminated: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"start">;
+    runnable_type: z.ZodOptional<z.ZodString>;
+    runnable_id: z.ZodOptional<z.ZodString>;
+    host_id: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    config: 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>>>;
+    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>>>;
+    run_id: z.ZodOptional<z.ZodString>;
+    event_id: z.ZodOptional<z.ZodString>;
+    execution_generation: z.ZodOptional<z.ZodNumber>;
+    execution_attempt: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+}, z.core.$catchall<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.ZodObject<{
+    type: z.ZodLiteral<"progress">;
+    fraction: z.ZodNumber;
+    message: z.ZodOptional<z.ZodString>;
+    run_id: z.ZodOptional<z.ZodString>;
+    event_id: z.ZodOptional<z.ZodString>;
+    execution_generation: z.ZodOptional<z.ZodNumber>;
+    execution_attempt: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"activity">;
+    message: z.ZodString;
+    run_id: z.ZodOptional<z.ZodString>;
+    event_id: z.ZodOptional<z.ZodString>;
+    execution_generation: z.ZodOptional<z.ZodNumber>;
+    execution_attempt: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"metric">;
+    key: z.ZodString;
+    value: 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>>>;
+    run_id: z.ZodOptional<z.ZodString>;
+    event_id: z.ZodOptional<z.ZodString>;
+    execution_generation: z.ZodOptional<z.ZodNumber>;
+    execution_attempt: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"log">;
+    level: z.ZodEnum<{
+        error: "error";
+        info: "info";
+        warn: "warn";
+        debug: "debug";
+    }>;
+    message: z.ZodString;
+    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>>>;
+    run_id: z.ZodOptional<z.ZodString>;
+    event_id: z.ZodOptional<z.ZodString>;
+    execution_generation: z.ZodOptional<z.ZodNumber>;
+    execution_attempt: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"artifact">;
+    name: z.ZodString;
+    artifact_kind: z.ZodOptional<z.ZodString>;
+    encoding: z.ZodOptional<z.ZodEnum<{
+        base64: "base64";
+        utf8: "utf8";
+    }>>;
+    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>>>;
+    sequence_no: z.ZodOptional<z.ZodNumber>;
+    mime_type: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodNumber>;
+    data: z.ZodOptional<z.ZodString>;
+    run_id: z.ZodOptional<z.ZodString>;
+    event_id: z.ZodOptional<z.ZodString>;
+    execution_generation: z.ZodOptional<z.ZodNumber>;
+    execution_attempt: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"status">;
+    status: z.ZodEnum<{
+        error: "error";
+        running: "running";
+        paused: "paused";
+        stopping: "stopping";
+        stopped: "stopped";
+        completed: "completed";
+    }>;
+    message: z.ZodOptional<z.ZodString>;
+    run_id: z.ZodOptional<z.ZodString>;
+    event_id: z.ZodOptional<z.ZodString>;
+    execution_generation: z.ZodOptional<z.ZodNumber>;
+    execution_attempt: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"done">;
+    summary: 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>>>;
+    run_id: z.ZodOptional<z.ZodString>;
+    event_id: z.ZodOptional<z.ZodString>;
+    execution_generation: z.ZodOptional<z.ZodNumber>;
+    execution_attempt: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>], "type">;
+export declare const runEventEnvelopeSchema: z.ZodObject<{
+    type: z.ZodString;
+    run_id: z.ZodOptional<z.ZodString>;
+    event_id: z.ZodOptional<z.ZodString>;
+    execution_generation: z.ZodOptional<z.ZodNumber>;
+    execution_attempt: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+}, z.core.$catchall<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>>>>;
+export declare const runEventSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"start">;
+    runnable_type: z.ZodOptional<z.ZodString>;
+    runnable_id: z.ZodOptional<z.ZodString>;
+    host_id: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    config: 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>>>;
+    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>>>;
+    run_id: z.ZodOptional<z.ZodString>;
+    event_id: z.ZodOptional<z.ZodString>;
+    execution_generation: z.ZodOptional<z.ZodNumber>;
+    execution_attempt: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+}, z.core.$catchall<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.ZodObject<{
+    type: z.ZodLiteral<"progress">;
+    fraction: z.ZodNumber;
+    message: z.ZodOptional<z.ZodString>;
+    run_id: z.ZodOptional<z.ZodString>;
+    event_id: z.ZodOptional<z.ZodString>;
+    execution_generation: z.ZodOptional<z.ZodNumber>;
+    execution_attempt: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"activity">;
+    message: z.ZodString;
+    run_id: z.ZodOptional<z.ZodString>;
+    event_id: z.ZodOptional<z.ZodString>;
+    execution_generation: z.ZodOptional<z.ZodNumber>;
+    execution_attempt: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"metric">;
+    key: z.ZodString;
+    value: 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>>>;
+    run_id: z.ZodOptional<z.ZodString>;
+    event_id: z.ZodOptional<z.ZodString>;
+    execution_generation: z.ZodOptional<z.ZodNumber>;
+    execution_attempt: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"log">;
+    level: z.ZodEnum<{
+        error: "error";
+        info: "info";
+        warn: "warn";
+        debug: "debug";
+    }>;
+    message: z.ZodString;
+    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>>>;
+    run_id: z.ZodOptional<z.ZodString>;
+    event_id: z.ZodOptional<z.ZodString>;
+    execution_generation: z.ZodOptional<z.ZodNumber>;
+    execution_attempt: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"artifact">;
+    name: z.ZodString;
+    artifact_kind: z.ZodOptional<z.ZodString>;
+    encoding: z.ZodOptional<z.ZodEnum<{
+        base64: "base64";
+        utf8: "utf8";
+    }>>;
+    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>>>;
+    sequence_no: z.ZodOptional<z.ZodNumber>;
+    mime_type: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodNumber>;
+    data: z.ZodOptional<z.ZodString>;
+    run_id: z.ZodOptional<z.ZodString>;
+    event_id: z.ZodOptional<z.ZodString>;
+    execution_generation: z.ZodOptional<z.ZodNumber>;
+    execution_attempt: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"status">;
+    status: z.ZodEnum<{
+        error: "error";
+        running: "running";
+        paused: "paused";
+        stopping: "stopping";
+        stopped: "stopped";
+        completed: "completed";
+    }>;
+    message: z.ZodOptional<z.ZodString>;
+    run_id: z.ZodOptional<z.ZodString>;
+    event_id: z.ZodOptional<z.ZodString>;
+    execution_generation: z.ZodOptional<z.ZodNumber>;
+    execution_attempt: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"done">;
+    summary: 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>>>;
+    run_id: z.ZodOptional<z.ZodString>;
+    event_id: z.ZodOptional<z.ZodString>;
+    execution_generation: z.ZodOptional<z.ZodNumber>;
+    execution_attempt: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>], "type">, z.ZodObject<{
+    type: z.ZodString;
+    run_id: z.ZodOptional<z.ZodString>;
+    event_id: z.ZodOptional<z.ZodString>;
+    execution_generation: z.ZodOptional<z.ZodNumber>;
+    execution_attempt: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+}, z.core.$catchall<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>>>>]>;
+export type RunnableEvent = z.infer<typeof runEventSchema>;
+export declare const RunnableEventLogDataSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"runnable.event">;
+    event: z.ZodObject<{
+        type: z.ZodString;
+        run_id: z.ZodOptional<z.ZodString>;
+        event_id: z.ZodOptional<z.ZodString>;
+        execution_generation: z.ZodOptional<z.ZodNumber>;
+        execution_attempt: z.ZodOptional<z.ZodNumber>;
+        timestamp: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$catchall<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>>>>;
+    mappedLogs: z.ZodArray<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.core.$strip>;
+export type RunnableEventLogData = z.infer<typeof RunnableEventLogDataSchema>;
+//# sourceMappingURL=events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/schemas/events.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAI5B,eAAO,MAAM,mBAAmB;;;;;;CAM/B,CAAC;AAIF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;qQAcF,CAAC;AAE5B,eAAO,MAAM,mBAAmB;;;;;;;;;iBAK9B,CAAC;AAEH,wFAAwF;AACxF,eAAO,MAAM,mBAAmB;;;;;;;;iBAI9B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;iBAM5B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;iBAMzB,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;EAA6B,CAAC;AACrE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;iBAW9B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;iBAK5B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;iBAI1B,CAAC;AAEH,eAAO,MAAM,gBAAgB,2FASnB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,MAAM,CAA6B,CAAC;AAElF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BASjC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;qQAIjC,CAAC;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uQAA4D,CAAC;AACxF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAC3D,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;iBAGrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

package/dist/schemas/events.js

@@ -0,0 +1,109 @@
+/** Shared core event protocol for HTTP and direct Runnable hosts. */
+import * as z from 'zod/v4';
+import { JsonObjectSchema, JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+import { RunActivitySchema, RunLogWriteSchema } from "./writes.js";
+export const eventEnvelopeFields = {
+    run_id: z.string().optional(),
+    event_id: z.string().min(1).optional(),
+    execution_generation: z.number().int().nonnegative().optional(),
+    execution_attempt: z.number().int().positive().optional(),
+    timestamp: z.number().optional()
+};
+// ── Generic core event types ────────────────────────────────────────────
+export const startEventSchema = z
+    .object({
+    ...eventEnvelopeFields,
+    type: z.literal('start'),
+    runnable_type: z.string().optional(),
+    runnable_id: z.string().optional(),
+    host_id: z.string().optional(),
+    name: z.string().optional(),
+    config: JsonObjectSchema.optional(),
+    metadata: JsonObjectSchema.optional()
+})
+    // Producers may put type-specific config at the top level; the
+    // dispatch folds those fields into `config` when no explicit
+    // `config` block is present.
+    .catchall(JsonValueSchema);
+export const progressEventSchema = z.object({
+    ...eventEnvelopeFields,
+    type: z.literal('progress'),
+    fraction: z.number().min(0).max(1),
+    message: z.string().optional()
+});
+/** A current description without asserting a percentage or changing execution state. */
+export const activityEventSchema = z.object({
+    ...eventEnvelopeFields,
+    type: z.literal('activity'),
+    message: RunActivitySchema.shape.message
+});
+export const metricEventSchema = z.object({
+    ...eventEnvelopeFields,
+    type: z.literal('metric'),
+    key: z.string(),
+    value: z.number(),
+    dimensions: JsonObjectSchema.optional()
+});
+export const logEventSchema = z.object({
+    ...eventEnvelopeFields,
+    type: z.literal('log'),
+    level: z.enum(['debug', 'info', 'warn', 'error']),
+    message: z.string(),
+    data: JsonValueSchema.optional()
+});
+export const ArtifactDataEncodingSchema = z.enum(['utf8', 'base64']);
+export const artifactEventSchema = z.object({
+    ...eventEnvelopeFields,
+    type: z.literal('artifact'),
+    name: z.string(),
+    artifact_kind: z.string().min(1).optional(),
+    encoding: ArtifactDataEncodingSchema.optional(),
+    metadata: JsonObjectSchema.optional(),
+    sequence_no: z.number().int().nonnegative().optional(),
+    mime_type: z.string().optional(),
+    size: z.number().optional(),
+    data: z.string().optional()
+});
+export const statusEventSchema = z.object({
+    ...eventEnvelopeFields,
+    type: z.literal('status'),
+    status: z.enum(['running', 'paused', 'stopping', 'stopped', 'completed', 'error']),
+    message: z.string().optional()
+});
+export const doneEventSchema = z.object({
+    ...eventEnvelopeFields,
+    type: z.literal('done'),
+    summary: JsonObjectSchema.optional()
+});
+export const CORE_EVENT_TYPES = [
+    'start',
+    'progress',
+    'activity',
+    'metric',
+    'log',
+    'artifact',
+    'status',
+    'done'
+];
+export const CORE_EVENT_TYPE_SET = new Set(CORE_EVENT_TYPES);
+export const coreEventDiscriminated = z.discriminatedUnion('type', [
+    startEventSchema,
+    progressEventSchema,
+    activityEventSchema,
+    metricEventSchema,
+    logEventSchema,
+    artifactEventSchema,
+    statusEventSchema,
+    doneEventSchema
+]);
+export const runEventEnvelopeSchema = z.object({
+    ...eventEnvelopeFields, type: z.string()
+}).catchall(JsonValueSchema).refine(event => !CORE_EVENT_TYPE_SET.has(event.type), {
+    message: 'Use the typed core schema for core event types', path: ['type']
+});
+export const runEventSchema = z.union([coreEventDiscriminated, runEventEnvelopeSchema]);
+export const RunnableEventLogDataSchema = z.object({
+    kind: z.literal('runnable.event'), event: runEventEnvelopeSchema,
+    mappedLogs: z.array(RunLogWriteSchema)
+});
+//# sourceMappingURL=events.js.map

package/dist/schemas/events.js.map

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

package/dist/schemas/index.d.ts

@@ -0,0 +1,12 @@
+export * from './contracts/index.ts';
+export * from './descriptors.ts';
+export * from './projection.ts';
+export * from './outcome.ts';
+export * from './runs.ts';
+export * from './panels.ts';
+export * from './events.ts';
+export * from './writes.ts';
+export * from './description.ts';
+export * from './context.ts';
+export * from './issues.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAEA,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AAEjC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/dist/schemas/index.js

@@ -0,0 +1,12 @@
+export * from "./contracts/index.js";
+export * from "./descriptors.js";
+export * from "./projection.js";
+export * from "./outcome.js";
+export * from "./runs.js";
+export * from "./panels.js";
+export * from "./events.js";
+export * from "./writes.js";
+export * from "./description.js";
+export * from "./context.js";
+export * from "./issues.js";
+//# sourceMappingURL=index.js.map