@agent-relay/factory 0.1.32 → 0.1.34

package/dist/observability/events.d.ts

@@ -0,0 +1,1315 @@
+import { z } from 'zod';
+export declare const FACTORY_CLOUD_EVENT_CONTRACT_V1: "factory.telemetry.v1";
+export declare const FACTORY_CLOUD_EVENT_MAX_BATCH_SIZE = 100;
+/** Leave headroom below Cloud's 256 KiB request-body limit. */
+export declare const FACTORY_CLOUD_EVENT_MAX_PAYLOAD_BYTES: number;
+export declare const FACTORY_CLOUD_RELEASE_REASONS_V1: readonly ["completed", "human_review", "factory_stopped", "waiting_for_human", "exited", "offline", "node_offline", "crashed", "reconciled_missing", "delivery_failed", "dispatch_failed", "source_state_changed", "other"];
+export type FactoryCloudReleaseReasonV1 = (typeof FACTORY_CLOUD_RELEASE_REASONS_V1)[number];
+export declare const FACTORY_CLOUD_CANCELLATION_REASONS_V1: readonly ["source_state_changed", "agent_spawn_failed", "agent_delivery_failed", "dispatch_failed"];
+export type FactoryCloudCancellationReasonV1 = (typeof FACTORY_CLOUD_CANCELLATION_REASONS_V1)[number];
+export declare const FACTORY_CLOUD_EVENT_TYPES: readonly ["instance.started", "instance.heartbeat", "instance.stopping", "instance.stopped", "run.queued", "run.started", "run.phase_changed", "run.waiting", "run.blocked", "run.succeeded", "run.failed", "run.cancelled", "agent.planned", "agent.spawned", "agent.adopted", "agent.resumed", "agent.exited", "agent.released", "clarification.requested", "clarification.delivered", "clarification.waiting", "clarification.answered", "clarification.woken", "clarification.escalated", "pull_request.discovered", "pull_request.published", "pull_request.ready", "pull_request.merged", "writeback.applied", "factory.failure", "factory.anomaly", "factory.snapshot"];
+export type FactoryCloudEventType = (typeof FACTORY_CLOUD_EVENT_TYPES)[number] | (string & {});
+export declare const FactoryCloudTraceIdV1Schema: z.ZodEffects<z.ZodString, string, string>;
+export declare const FactoryCloudSpanIdV1Schema: z.ZodEffects<z.ZodString, string, string>;
+/**
+ * Deliberately narrow operational attributes. This is not a general log bag:
+ * task text, prompts, issue descriptions, messages, paths, URLs, command lines,
+ * stack traces, and raw error messages have no representable field.
+ */
+export declare const FactoryCloudEventAttributesV1Schema: z.ZodObject<{
+    backend: z.ZodOptional<z.ZodString>;
+    mode: z.ZodOptional<z.ZodString>;
+    component: z.ZodOptional<z.ZodString>;
+    operation: z.ZodOptional<z.ZodString>;
+    errorClass: z.ZodOptional<z.ZodString>;
+    errorCode: z.ZodOptional<z.ZodString>;
+    errorFingerprint: z.ZodOptional<z.ZodString>;
+    retryable: z.ZodOptional<z.ZodBoolean>;
+    attempt: z.ZodOptional<z.ZodNumber>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    agentRole: z.ZodOptional<z.ZodString>;
+    invocationId: z.ZodOptional<z.ZodString>;
+    nodeId: z.ZodOptional<z.ZodString>;
+    previousPhase: z.ZodOptional<z.ZodString>;
+    releaseReason: z.ZodOptional<z.ZodEnum<["completed", "human_review", "factory_stopped", "waiting_for_human", "exited", "offline", "node_offline", "crashed", "reconciled_missing", "delivery_failed", "dispatch_failed", "source_state_changed", "other"]>>;
+    cancellationReason: z.ZodOptional<z.ZodEnum<["source_state_changed", "agent_spawn_failed", "agent_delivery_failed", "dispatch_failed"]>>;
+    dryRun: z.ZodOptional<z.ZodBoolean>;
+    count: z.ZodOptional<z.ZodNumber>;
+    activeRuns: z.ZodOptional<z.ZodNumber>;
+    queuedRuns: z.ZodOptional<z.ZodNumber>;
+    trackedAgents: z.ZodOptional<z.ZodNumber>;
+    unownedAgents: z.ZodOptional<z.ZodNumber>;
+    outboxDepth: z.ZodOptional<z.ZodNumber>;
+    outboxOldestAgeMs: z.ZodOptional<z.ZodNumber>;
+    droppedEvents: z.ZodOptional<z.ZodNumber>;
+    transport: z.ZodOptional<z.ZodString>;
+    locality: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    transport?: string | undefined;
+    dryRun?: boolean | undefined;
+    backend?: string | undefined;
+    mode?: string | undefined;
+    component?: string | undefined;
+    operation?: string | undefined;
+    errorClass?: string | undefined;
+    errorCode?: string | undefined;
+    errorFingerprint?: string | undefined;
+    retryable?: boolean | undefined;
+    attempt?: number | undefined;
+    durationMs?: number | undefined;
+    agentRole?: string | undefined;
+    invocationId?: string | undefined;
+    nodeId?: string | undefined;
+    previousPhase?: string | undefined;
+    releaseReason?: "completed" | "human_review" | "factory_stopped" | "waiting_for_human" | "exited" | "offline" | "node_offline" | "crashed" | "reconciled_missing" | "delivery_failed" | "dispatch_failed" | "source_state_changed" | "other" | undefined;
+    cancellationReason?: "dispatch_failed" | "source_state_changed" | "agent_spawn_failed" | "agent_delivery_failed" | undefined;
+    count?: number | undefined;
+    activeRuns?: number | undefined;
+    queuedRuns?: number | undefined;
+    trackedAgents?: number | undefined;
+    unownedAgents?: number | undefined;
+    outboxDepth?: number | undefined;
+    outboxOldestAgeMs?: number | undefined;
+    droppedEvents?: number | undefined;
+    locality?: string | undefined;
+}, {
+    transport?: string | undefined;
+    dryRun?: boolean | undefined;
+    backend?: string | undefined;
+    mode?: string | undefined;
+    component?: string | undefined;
+    operation?: string | undefined;
+    errorClass?: string | undefined;
+    errorCode?: string | undefined;
+    errorFingerprint?: string | undefined;
+    retryable?: boolean | undefined;
+    attempt?: number | undefined;
+    durationMs?: number | undefined;
+    agentRole?: string | undefined;
+    invocationId?: string | undefined;
+    nodeId?: string | undefined;
+    previousPhase?: string | undefined;
+    releaseReason?: "completed" | "human_review" | "factory_stopped" | "waiting_for_human" | "exited" | "offline" | "node_offline" | "crashed" | "reconciled_missing" | "delivery_failed" | "dispatch_failed" | "source_state_changed" | "other" | undefined;
+    cancellationReason?: "dispatch_failed" | "source_state_changed" | "agent_spawn_failed" | "agent_delivery_failed" | undefined;
+    count?: number | undefined;
+    activeRuns?: number | undefined;
+    queuedRuns?: number | undefined;
+    trackedAgents?: number | undefined;
+    unownedAgents?: number | undefined;
+    outboxDepth?: number | undefined;
+    outboxOldestAgeMs?: number | undefined;
+    droppedEvents?: number | undefined;
+    locality?: string | undefined;
+}>;
+export type FactoryCloudEventAttributesV1 = z.infer<typeof FactoryCloudEventAttributesV1Schema>;
+export declare const FactoryCloudInstanceV1Schema: z.ZodObject<{
+    id: z.ZodString;
+    bootId: z.ZodString;
+    version: z.ZodString;
+    metadata: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        backend: z.ZodOptional<z.ZodString>;
+        mode: z.ZodOptional<z.ZodString>;
+        platform: z.ZodOptional<z.ZodString>;
+        arch: z.ZodOptional<z.ZodString>;
+        runtime: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        name?: string | undefined;
+        backend?: string | undefined;
+        mode?: string | undefined;
+        platform?: string | undefined;
+        arch?: string | undefined;
+        runtime?: string | undefined;
+    }, {
+        name?: string | undefined;
+        backend?: string | undefined;
+        mode?: string | undefined;
+        platform?: string | undefined;
+        arch?: string | undefined;
+        runtime?: string | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    bootId: string;
+    version: string;
+    metadata?: {
+        name?: string | undefined;
+        backend?: string | undefined;
+        mode?: string | undefined;
+        platform?: string | undefined;
+        arch?: string | undefined;
+        runtime?: string | undefined;
+    } | undefined;
+}, {
+    id: string;
+    bootId: string;
+    version: string;
+    metadata?: {
+        name?: string | undefined;
+        backend?: string | undefined;
+        mode?: string | undefined;
+        platform?: string | undefined;
+        arch?: string | undefined;
+        runtime?: string | undefined;
+    } | undefined;
+}>;
+export type FactoryCloudInstanceV1 = z.infer<typeof FactoryCloudInstanceV1Schema>;
+export declare const FactoryCloudEventInputV1Schema: z.ZodEffects<z.ZodObject<{
+    readonly id: z.ZodString;
+    readonly occurredAt: z.ZodString;
+    readonly type: z.ZodString;
+    readonly level: z.ZodOptional<z.ZodEnum<["debug", "info", "warn", "error"]>>;
+    readonly runId: z.ZodOptional<z.ZodString>;
+    readonly phase: z.ZodOptional<z.ZodString>;
+    readonly status: z.ZodOptional<z.ZodEnum<["queued", "running", "waiting", "blocked", "succeeded", "failed", "cancelled"]>>;
+    readonly run: z.ZodOptional<z.ZodObject<{
+        source: z.ZodOptional<z.ZodString>;
+        repository: z.ZodOptional<z.ZodString>;
+        issueKey: z.ZodOptional<z.ZodString>;
+        recipe: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        source?: string | undefined;
+        repository?: string | undefined;
+        issueKey?: string | undefined;
+        recipe?: string | undefined;
+    }, {
+        source?: string | undefined;
+        repository?: string | undefined;
+        issueKey?: string | undefined;
+        recipe?: string | undefined;
+    }>>;
+    readonly attributes: z.ZodOptional<z.ZodObject<{
+        backend: z.ZodOptional<z.ZodString>;
+        mode: z.ZodOptional<z.ZodString>;
+        component: z.ZodOptional<z.ZodString>;
+        operation: z.ZodOptional<z.ZodString>;
+        errorClass: z.ZodOptional<z.ZodString>;
+        errorCode: z.ZodOptional<z.ZodString>;
+        errorFingerprint: z.ZodOptional<z.ZodString>;
+        retryable: z.ZodOptional<z.ZodBoolean>;
+        attempt: z.ZodOptional<z.ZodNumber>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        agentRole: z.ZodOptional<z.ZodString>;
+        invocationId: z.ZodOptional<z.ZodString>;
+        nodeId: z.ZodOptional<z.ZodString>;
+        previousPhase: z.ZodOptional<z.ZodString>;
+        releaseReason: z.ZodOptional<z.ZodEnum<["completed", "human_review", "factory_stopped", "waiting_for_human", "exited", "offline", "node_offline", "crashed", "reconciled_missing", "delivery_failed", "dispatch_failed", "source_state_changed", "other"]>>;
+        cancellationReason: z.ZodOptional<z.ZodEnum<["source_state_changed", "agent_spawn_failed", "agent_delivery_failed", "dispatch_failed"]>>;
+        dryRun: z.ZodOptional<z.ZodBoolean>;
+        count: z.ZodOptional<z.ZodNumber>;
+        activeRuns: z.ZodOptional<z.ZodNumber>;
+        queuedRuns: z.ZodOptional<z.ZodNumber>;
+        trackedAgents: z.ZodOptional<z.ZodNumber>;
+        unownedAgents: z.ZodOptional<z.ZodNumber>;
+        outboxDepth: z.ZodOptional<z.ZodNumber>;
+        outboxOldestAgeMs: z.ZodOptional<z.ZodNumber>;
+        droppedEvents: z.ZodOptional<z.ZodNumber>;
+        transport: z.ZodOptional<z.ZodString>;
+        locality: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        transport?: string | undefined;
+        dryRun?: boolean | undefined;
+        backend?: string | undefined;
+        mode?: string | undefined;
+        component?: string | undefined;
+        operation?: string | undefined;
+        errorClass?: string | undefined;
+        errorCode?: string | undefined;
+        errorFingerprint?: string | undefined;
+        retryable?: boolean | undefined;
+        attempt?: number | undefined;
+        durationMs?: number | undefined;
+        agentRole?: string | undefined;
+        invocationId?: string | undefined;
+        nodeId?: string | undefined;
+        previousPhase?: string | undefined;
+        releaseReason?: "completed" | "human_review" | "factory_stopped" | "waiting_for_human" | "exited" | "offline" | "node_offline" | "crashed" | "reconciled_missing" | "delivery_failed" | "dispatch_failed" | "source_state_changed" | "other" | undefined;
+        cancellationReason?: "dispatch_failed" | "source_state_changed" | "agent_spawn_failed" | "agent_delivery_failed" | undefined;
+        count?: number | undefined;
+        activeRuns?: number | undefined;
+        queuedRuns?: number | undefined;
+        trackedAgents?: number | undefined;
+        unownedAgents?: number | undefined;
+        outboxDepth?: number | undefined;
+        outboxOldestAgeMs?: number | undefined;
+        droppedEvents?: number | undefined;
+        locality?: string | undefined;
+    }, {
+        transport?: string | undefined;
+        dryRun?: boolean | undefined;
+        backend?: string | undefined;
+        mode?: string | undefined;
+        component?: string | undefined;
+        operation?: string | undefined;
+        errorClass?: string | undefined;
+        errorCode?: string | undefined;
+        errorFingerprint?: string | undefined;
+        retryable?: boolean | undefined;
+        attempt?: number | undefined;
+        durationMs?: number | undefined;
+        agentRole?: string | undefined;
+        invocationId?: string | undefined;
+        nodeId?: string | undefined;
+        previousPhase?: string | undefined;
+        releaseReason?: "completed" | "human_review" | "factory_stopped" | "waiting_for_human" | "exited" | "offline" | "node_offline" | "crashed" | "reconciled_missing" | "delivery_failed" | "dispatch_failed" | "source_state_changed" | "other" | undefined;
+        cancellationReason?: "dispatch_failed" | "source_state_changed" | "agent_spawn_failed" | "agent_delivery_failed" | undefined;
+        count?: number | undefined;
+        activeRuns?: number | undefined;
+        queuedRuns?: number | undefined;
+        trackedAgents?: number | undefined;
+        unownedAgents?: number | undefined;
+        outboxDepth?: number | undefined;
+        outboxOldestAgeMs?: number | undefined;
+        droppedEvents?: number | undefined;
+        locality?: string | undefined;
+    }>>;
+    readonly trace: z.ZodOptional<z.ZodObject<{
+        traceId: z.ZodEffects<z.ZodString, string, string>;
+        spanId: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        parentSpanId: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    }, "strict", z.ZodTypeAny, {
+        traceId: string;
+        spanId?: string | undefined;
+        parentSpanId?: string | undefined;
+    }, {
+        traceId: string;
+        spanId?: string | undefined;
+        parentSpanId?: string | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    type: string;
+    id: string;
+    occurredAt: string;
+    status?: "blocked" | "failed" | "queued" | "running" | "waiting" | "succeeded" | "cancelled" | undefined;
+    level?: "debug" | "info" | "warn" | "error" | undefined;
+    runId?: string | undefined;
+    phase?: string | undefined;
+    run?: {
+        source?: string | undefined;
+        repository?: string | undefined;
+        issueKey?: string | undefined;
+        recipe?: string | undefined;
+    } | undefined;
+    attributes?: {
+        transport?: string | undefined;
+        dryRun?: boolean | undefined;
+        backend?: string | undefined;
+        mode?: string | undefined;
+        component?: string | undefined;
+        operation?: string | undefined;
+        errorClass?: string | undefined;
+        errorCode?: string | undefined;
+        errorFingerprint?: string | undefined;
+        retryable?: boolean | undefined;
+        attempt?: number | undefined;
+        durationMs?: number | undefined;
+        agentRole?: string | undefined;
+        invocationId?: string | undefined;
+        nodeId?: string | undefined;
+        previousPhase?: string | undefined;
+        releaseReason?: "completed" | "human_review" | "factory_stopped" | "waiting_for_human" | "exited" | "offline" | "node_offline" | "crashed" | "reconciled_missing" | "delivery_failed" | "dispatch_failed" | "source_state_changed" | "other" | undefined;
+        cancellationReason?: "dispatch_failed" | "source_state_changed" | "agent_spawn_failed" | "agent_delivery_failed" | undefined;
+        count?: number | undefined;
+        activeRuns?: number | undefined;
+        queuedRuns?: number | undefined;
+        trackedAgents?: number | undefined;
+        unownedAgents?: number | undefined;
+        outboxDepth?: number | undefined;
+        outboxOldestAgeMs?: number | undefined;
+        droppedEvents?: number | undefined;
+        locality?: string | undefined;
+    } | undefined;
+    trace?: {
+        traceId: string;
+        spanId?: string | undefined;
+        parentSpanId?: string | undefined;
+    } | undefined;
+}, {
+    type: string;
+    id: string;
+    occurredAt: string;
+    status?: "blocked" | "failed" | "queued" | "running" | "waiting" | "succeeded" | "cancelled" | undefined;
+    level?: "debug" | "info" | "warn" | "error" | undefined;
+    runId?: string | undefined;
+    phase?: string | undefined;
+    run?: {
+        source?: string | undefined;
+        repository?: string | undefined;
+        issueKey?: string | undefined;
+        recipe?: string | undefined;
+    } | undefined;
+    attributes?: {
+        transport?: string | undefined;
+        dryRun?: boolean | undefined;
+        backend?: string | undefined;
+        mode?: string | undefined;
+        component?: string | undefined;
+        operation?: string | undefined;
+        errorClass?: string | undefined;
+        errorCode?: string | undefined;
+        errorFingerprint?: string | undefined;
+        retryable?: boolean | undefined;
+        attempt?: number | undefined;
+        durationMs?: number | undefined;
+        agentRole?: string | undefined;
+        invocationId?: string | undefined;
+        nodeId?: string | undefined;
+        previousPhase?: string | undefined;
+        releaseReason?: "completed" | "human_review" | "factory_stopped" | "waiting_for_human" | "exited" | "offline" | "node_offline" | "crashed" | "reconciled_missing" | "delivery_failed" | "dispatch_failed" | "source_state_changed" | "other" | undefined;
+        cancellationReason?: "dispatch_failed" | "source_state_changed" | "agent_spawn_failed" | "agent_delivery_failed" | undefined;
+        count?: number | undefined;
+        activeRuns?: number | undefined;
+        queuedRuns?: number | undefined;
+        trackedAgents?: number | undefined;
+        unownedAgents?: number | undefined;
+        outboxDepth?: number | undefined;
+        outboxOldestAgeMs?: number | undefined;
+        droppedEvents?: number | undefined;
+        locality?: string | undefined;
+    } | undefined;
+    trace?: {
+        traceId: string;
+        spanId?: string | undefined;
+        parentSpanId?: string | undefined;
+    } | undefined;
+}>, {
+    type: string;
+    id: string;
+    occurredAt: string;
+    status?: "blocked" | "failed" | "queued" | "running" | "waiting" | "succeeded" | "cancelled" | undefined;
+    level?: "debug" | "info" | "warn" | "error" | undefined;
+    runId?: string | undefined;
+    phase?: string | undefined;
+    run?: {
+        source?: string | undefined;
+        repository?: string | undefined;
+        issueKey?: string | undefined;
+        recipe?: string | undefined;
+    } | undefined;
+    attributes?: {
+        transport?: string | undefined;
+        dryRun?: boolean | undefined;
+        backend?: string | undefined;
+        mode?: string | undefined;
+        component?: string | undefined;
+        operation?: string | undefined;
+        errorClass?: string | undefined;
+        errorCode?: string | undefined;
+        errorFingerprint?: string | undefined;
+        retryable?: boolean | undefined;
+        attempt?: number | undefined;
+        durationMs?: number | undefined;
+        agentRole?: string | undefined;
+        invocationId?: string | undefined;
+        nodeId?: string | undefined;
+        previousPhase?: string | undefined;
+        releaseReason?: "completed" | "human_review" | "factory_stopped" | "waiting_for_human" | "exited" | "offline" | "node_offline" | "crashed" | "reconciled_missing" | "delivery_failed" | "dispatch_failed" | "source_state_changed" | "other" | undefined;
+        cancellationReason?: "dispatch_failed" | "source_state_changed" | "agent_spawn_failed" | "agent_delivery_failed" | undefined;
+        count?: number | undefined;
+        activeRuns?: number | undefined;
+        queuedRuns?: number | undefined;
+        trackedAgents?: number | undefined;
+        unownedAgents?: number | undefined;
+        outboxDepth?: number | undefined;
+        outboxOldestAgeMs?: number | undefined;
+        droppedEvents?: number | undefined;
+        locality?: string | undefined;
+    } | undefined;
+    trace?: {
+        traceId: string;
+        spanId?: string | undefined;
+        parentSpanId?: string | undefined;
+    } | undefined;
+}, {
+    type: string;
+    id: string;
+    occurredAt: string;
+    status?: "blocked" | "failed" | "queued" | "running" | "waiting" | "succeeded" | "cancelled" | undefined;
+    level?: "debug" | "info" | "warn" | "error" | undefined;
+    runId?: string | undefined;
+    phase?: string | undefined;
+    run?: {
+        source?: string | undefined;
+        repository?: string | undefined;
+        issueKey?: string | undefined;
+        recipe?: string | undefined;
+    } | undefined;
+    attributes?: {
+        transport?: string | undefined;
+        dryRun?: boolean | undefined;
+        backend?: string | undefined;
+        mode?: string | undefined;
+        component?: string | undefined;
+        operation?: string | undefined;
+        errorClass?: string | undefined;
+        errorCode?: string | undefined;
+        errorFingerprint?: string | undefined;
+        retryable?: boolean | undefined;
+        attempt?: number | undefined;
+        durationMs?: number | undefined;
+        agentRole?: string | undefined;
+        invocationId?: string | undefined;
+        nodeId?: string | undefined;
+        previousPhase?: string | undefined;
+        releaseReason?: "completed" | "human_review" | "factory_stopped" | "waiting_for_human" | "exited" | "offline" | "node_offline" | "crashed" | "reconciled_missing" | "delivery_failed" | "dispatch_failed" | "source_state_changed" | "other" | undefined;
+        cancellationReason?: "dispatch_failed" | "source_state_changed" | "agent_spawn_failed" | "agent_delivery_failed" | undefined;
+        count?: number | undefined;
+        activeRuns?: number | undefined;
+        queuedRuns?: number | undefined;
+        trackedAgents?: number | undefined;
+        unownedAgents?: number | undefined;
+        outboxDepth?: number | undefined;
+        outboxOldestAgeMs?: number | undefined;
+        droppedEvents?: number | undefined;
+        locality?: string | undefined;
+    } | undefined;
+    trace?: {
+        traceId: string;
+        spanId?: string | undefined;
+        parentSpanId?: string | undefined;
+    } | undefined;
+}>;
+export declare const FactoryCloudEventV1Schema: z.ZodEffects<z.ZodObject<{
+    sequence: z.ZodNumber;
+    id: z.ZodString;
+    occurredAt: z.ZodString;
+    type: z.ZodString;
+    level: z.ZodOptional<z.ZodEnum<["debug", "info", "warn", "error"]>>;
+    runId: z.ZodOptional<z.ZodString>;
+    phase: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<["queued", "running", "waiting", "blocked", "succeeded", "failed", "cancelled"]>>;
+    run: z.ZodOptional<z.ZodObject<{
+        source: z.ZodOptional<z.ZodString>;
+        repository: z.ZodOptional<z.ZodString>;
+        issueKey: z.ZodOptional<z.ZodString>;
+        recipe: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        source?: string | undefined;
+        repository?: string | undefined;
+        issueKey?: string | undefined;
+        recipe?: string | undefined;
+    }, {
+        source?: string | undefined;
+        repository?: string | undefined;
+        issueKey?: string | undefined;
+        recipe?: string | undefined;
+    }>>;
+    attributes: z.ZodOptional<z.ZodObject<{
+        backend: z.ZodOptional<z.ZodString>;
+        mode: z.ZodOptional<z.ZodString>;
+        component: z.ZodOptional<z.ZodString>;
+        operation: z.ZodOptional<z.ZodString>;
+        errorClass: z.ZodOptional<z.ZodString>;
+        errorCode: z.ZodOptional<z.ZodString>;
+        errorFingerprint: z.ZodOptional<z.ZodString>;
+        retryable: z.ZodOptional<z.ZodBoolean>;
+        attempt: z.ZodOptional<z.ZodNumber>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        agentRole: z.ZodOptional<z.ZodString>;
+        invocationId: z.ZodOptional<z.ZodString>;
+        nodeId: z.ZodOptional<z.ZodString>;
+        previousPhase: z.ZodOptional<z.ZodString>;
+        releaseReason: z.ZodOptional<z.ZodEnum<["completed", "human_review", "factory_stopped", "waiting_for_human", "exited", "offline", "node_offline", "crashed", "reconciled_missing", "delivery_failed", "dispatch_failed", "source_state_changed", "other"]>>;
+        cancellationReason: z.ZodOptional<z.ZodEnum<["source_state_changed", "agent_spawn_failed", "agent_delivery_failed", "dispatch_failed"]>>;
+        dryRun: z.ZodOptional<z.ZodBoolean>;
+        count: z.ZodOptional<z.ZodNumber>;
+        activeRuns: z.ZodOptional<z.ZodNumber>;
+        queuedRuns: z.ZodOptional<z.ZodNumber>;
+        trackedAgents: z.ZodOptional<z.ZodNumber>;
+        unownedAgents: z.ZodOptional<z.ZodNumber>;
+        outboxDepth: z.ZodOptional<z.ZodNumber>;
+        outboxOldestAgeMs: z.ZodOptional<z.ZodNumber>;
+        droppedEvents: z.ZodOptional<z.ZodNumber>;
+        transport: z.ZodOptional<z.ZodString>;
+        locality: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        transport?: string | undefined;
+        dryRun?: boolean | undefined;
+        backend?: string | undefined;
+        mode?: string | undefined;
+        component?: string | undefined;
+        operation?: string | undefined;
+        errorClass?: string | undefined;
+        errorCode?: string | undefined;
+        errorFingerprint?: string | undefined;
+        retryable?: boolean | undefined;
+        attempt?: number | undefined;
+        durationMs?: number | undefined;
+        agentRole?: string | undefined;
+        invocationId?: string | undefined;
+        nodeId?: string | undefined;
+        previousPhase?: string | undefined;
+        releaseReason?: "completed" | "human_review" | "factory_stopped" | "waiting_for_human" | "exited" | "offline" | "node_offline" | "crashed" | "reconciled_missing" | "delivery_failed" | "dispatch_failed" | "source_state_changed" | "other" | undefined;
+        cancellationReason?: "dispatch_failed" | "source_state_changed" | "agent_spawn_failed" | "agent_delivery_failed" | undefined;
+        count?: number | undefined;
+        activeRuns?: number | undefined;
+        queuedRuns?: number | undefined;
+        trackedAgents?: number | undefined;
+        unownedAgents?: number | undefined;
+        outboxDepth?: number | undefined;
+        outboxOldestAgeMs?: number | undefined;
+        droppedEvents?: number | undefined;
+        locality?: string | undefined;
+    }, {
+        transport?: string | undefined;
+        dryRun?: boolean | undefined;
+        backend?: string | undefined;
+        mode?: string | undefined;
+        component?: string | undefined;
+        operation?: string | undefined;
+        errorClass?: string | undefined;
+        errorCode?: string | undefined;
+        errorFingerprint?: string | undefined;
+        retryable?: boolean | undefined;
+        attempt?: number | undefined;
+        durationMs?: number | undefined;
+        agentRole?: string | undefined;
+        invocationId?: string | undefined;
+        nodeId?: string | undefined;
+        previousPhase?: string | undefined;
+        releaseReason?: "completed" | "human_review" | "factory_stopped" | "waiting_for_human" | "exited" | "offline" | "node_offline" | "crashed" | "reconciled_missing" | "delivery_failed" | "dispatch_failed" | "source_state_changed" | "other" | undefined;
+        cancellationReason?: "dispatch_failed" | "source_state_changed" | "agent_spawn_failed" | "agent_delivery_failed" | undefined;
+        count?: number | undefined;
+        activeRuns?: number | undefined;
+        queuedRuns?: number | undefined;
+        trackedAgents?: number | undefined;
+        unownedAgents?: number | undefined;
+        outboxDepth?: number | undefined;
+        outboxOldestAgeMs?: number | undefined;
+        droppedEvents?: number | undefined;
+        locality?: string | undefined;
+    }>>;
+    trace: z.ZodOptional<z.ZodObject<{
+        traceId: z.ZodEffects<z.ZodString, string, string>;
+        spanId: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        parentSpanId: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    }, "strict", z.ZodTypeAny, {
+        traceId: string;
+        spanId?: string | undefined;
+        parentSpanId?: string | undefined;
+    }, {
+        traceId: string;
+        spanId?: string | undefined;
+        parentSpanId?: string | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    type: string;
+    id: string;
+    occurredAt: string;
+    sequence: number;
+    status?: "blocked" | "failed" | "queued" | "running" | "waiting" | "succeeded" | "cancelled" | undefined;
+    level?: "debug" | "info" | "warn" | "error" | undefined;
+    runId?: string | undefined;
+    phase?: string | undefined;
+    run?: {
+        source?: string | undefined;
+        repository?: string | undefined;
+        issueKey?: string | undefined;
+        recipe?: string | undefined;
+    } | undefined;
+    attributes?: {
+        transport?: string | undefined;
+        dryRun?: boolean | undefined;
+        backend?: string | undefined;
+        mode?: string | undefined;
+        component?: string | undefined;
+        operation?: string | undefined;
+        errorClass?: string | undefined;
+        errorCode?: string | undefined;
+        errorFingerprint?: string | undefined;
+        retryable?: boolean | undefined;
+        attempt?: number | undefined;
+        durationMs?: number | undefined;
+        agentRole?: string | undefined;
+        invocationId?: string | undefined;
+        nodeId?: string | undefined;
+        previousPhase?: string | undefined;
+        releaseReason?: "completed" | "human_review" | "factory_stopped" | "waiting_for_human" | "exited" | "offline" | "node_offline" | "crashed" | "reconciled_missing" | "delivery_failed" | "dispatch_failed" | "source_state_changed" | "other" | undefined;
+        cancellationReason?: "dispatch_failed" | "source_state_changed" | "agent_spawn_failed" | "agent_delivery_failed" | undefined;
+        count?: number | undefined;
+        activeRuns?: number | undefined;
+        queuedRuns?: number | undefined;
+        trackedAgents?: number | undefined;
+        unownedAgents?: number | undefined;
+        outboxDepth?: number | undefined;
+        outboxOldestAgeMs?: number | undefined;
+        droppedEvents?: number | undefined;
+        locality?: string | undefined;
+    } | undefined;
+    trace?: {
+        traceId: string;
+        spanId?: string | undefined;
+        parentSpanId?: string | undefined;
+    } | undefined;
+}, {
+    type: string;
+    id: string;
+    occurredAt: string;
+    sequence: number;
+    status?: "blocked" | "failed" | "queued" | "running" | "waiting" | "succeeded" | "cancelled" | undefined;
+    level?: "debug" | "info" | "warn" | "error" | undefined;
+    runId?: string | undefined;
+    phase?: string | undefined;
+    run?: {
+        source?: string | undefined;
+        repository?: string | undefined;
+        issueKey?: string | undefined;
+        recipe?: string | undefined;
+    } | undefined;
+    attributes?: {
+        transport?: string | undefined;
+        dryRun?: boolean | undefined;
+        backend?: string | undefined;
+        mode?: string | undefined;
+        component?: string | undefined;
+        operation?: string | undefined;
+        errorClass?: string | undefined;
+        errorCode?: string | undefined;
+        errorFingerprint?: string | undefined;
+        retryable?: boolean | undefined;
+        attempt?: number | undefined;
+        durationMs?: number | undefined;
+        agentRole?: string | undefined;
+        invocationId?: string | undefined;
+        nodeId?: string | undefined;
+        previousPhase?: string | undefined;
+        releaseReason?: "completed" | "human_review" | "factory_stopped" | "waiting_for_human" | "exited" | "offline" | "node_offline" | "crashed" | "reconciled_missing" | "delivery_failed" | "dispatch_failed" | "source_state_changed" | "other" | undefined;
+        cancellationReason?: "dispatch_failed" | "source_state_changed" | "agent_spawn_failed" | "agent_delivery_failed" | undefined;
+        count?: number | undefined;
+        activeRuns?: number | undefined;
+        queuedRuns?: number | undefined;
+        trackedAgents?: number | undefined;
+        unownedAgents?: number | undefined;
+        outboxDepth?: number | undefined;
+        outboxOldestAgeMs?: number | undefined;
+        droppedEvents?: number | undefined;
+        locality?: string | undefined;
+    } | undefined;
+    trace?: {
+        traceId: string;
+        spanId?: string | undefined;
+        parentSpanId?: string | undefined;
+    } | undefined;
+}>, {
+    type: string;
+    id: string;
+    occurredAt: string;
+    sequence: number;
+    status?: "blocked" | "failed" | "queued" | "running" | "waiting" | "succeeded" | "cancelled" | undefined;
+    level?: "debug" | "info" | "warn" | "error" | undefined;
+    runId?: string | undefined;
+    phase?: string | undefined;
+    run?: {
+        source?: string | undefined;
+        repository?: string | undefined;
+        issueKey?: string | undefined;
+        recipe?: string | undefined;
+    } | undefined;
+    attributes?: {
+        transport?: string | undefined;
+        dryRun?: boolean | undefined;
+        backend?: string | undefined;
+        mode?: string | undefined;
+        component?: string | undefined;
+        operation?: string | undefined;
+        errorClass?: string | undefined;
+        errorCode?: string | undefined;
+        errorFingerprint?: string | undefined;
+        retryable?: boolean | undefined;
+        attempt?: number | undefined;
+        durationMs?: number | undefined;
+        agentRole?: string | undefined;
+        invocationId?: string | undefined;
+        nodeId?: string | undefined;
+        previousPhase?: string | undefined;
+        releaseReason?: "completed" | "human_review" | "factory_stopped" | "waiting_for_human" | "exited" | "offline" | "node_offline" | "crashed" | "reconciled_missing" | "delivery_failed" | "dispatch_failed" | "source_state_changed" | "other" | undefined;
+        cancellationReason?: "dispatch_failed" | "source_state_changed" | "agent_spawn_failed" | "agent_delivery_failed" | undefined;
+        count?: number | undefined;
+        activeRuns?: number | undefined;
+        queuedRuns?: number | undefined;
+        trackedAgents?: number | undefined;
+        unownedAgents?: number | undefined;
+        outboxDepth?: number | undefined;
+        outboxOldestAgeMs?: number | undefined;
+        droppedEvents?: number | undefined;
+        locality?: string | undefined;
+    } | undefined;
+    trace?: {
+        traceId: string;
+        spanId?: string | undefined;
+        parentSpanId?: string | undefined;
+    } | undefined;
+}, {
+    type: string;
+    id: string;
+    occurredAt: string;
+    sequence: number;
+    status?: "blocked" | "failed" | "queued" | "running" | "waiting" | "succeeded" | "cancelled" | undefined;
+    level?: "debug" | "info" | "warn" | "error" | undefined;
+    runId?: string | undefined;
+    phase?: string | undefined;
+    run?: {
+        source?: string | undefined;
+        repository?: string | undefined;
+        issueKey?: string | undefined;
+        recipe?: string | undefined;
+    } | undefined;
+    attributes?: {
+        transport?: string | undefined;
+        dryRun?: boolean | undefined;
+        backend?: string | undefined;
+        mode?: string | undefined;
+        component?: string | undefined;
+        operation?: string | undefined;
+        errorClass?: string | undefined;
+        errorCode?: string | undefined;
+        errorFingerprint?: string | undefined;
+        retryable?: boolean | undefined;
+        attempt?: number | undefined;
+        durationMs?: number | undefined;
+        agentRole?: string | undefined;
+        invocationId?: string | undefined;
+        nodeId?: string | undefined;
+        previousPhase?: string | undefined;
+        releaseReason?: "completed" | "human_review" | "factory_stopped" | "waiting_for_human" | "exited" | "offline" | "node_offline" | "crashed" | "reconciled_missing" | "delivery_failed" | "dispatch_failed" | "source_state_changed" | "other" | undefined;
+        cancellationReason?: "dispatch_failed" | "source_state_changed" | "agent_spawn_failed" | "agent_delivery_failed" | undefined;
+        count?: number | undefined;
+        activeRuns?: number | undefined;
+        queuedRuns?: number | undefined;
+        trackedAgents?: number | undefined;
+        unownedAgents?: number | undefined;
+        outboxDepth?: number | undefined;
+        outboxOldestAgeMs?: number | undefined;
+        droppedEvents?: number | undefined;
+        locality?: string | undefined;
+    } | undefined;
+    trace?: {
+        traceId: string;
+        spanId?: string | undefined;
+        parentSpanId?: string | undefined;
+    } | undefined;
+}>;
+export type FactoryCloudEventInputV1 = z.infer<typeof FactoryCloudEventInputV1Schema>;
+export type FactoryCloudEventV1 = z.infer<typeof FactoryCloudEventV1Schema>;
+export declare const FactoryCloudEventBatchV1Schema: z.ZodObject<{
+    contract: z.ZodLiteral<"factory.telemetry.v1">;
+    instance: z.ZodObject<{
+        id: z.ZodString;
+        bootId: z.ZodString;
+        version: z.ZodString;
+        metadata: z.ZodOptional<z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            backend: z.ZodOptional<z.ZodString>;
+            mode: z.ZodOptional<z.ZodString>;
+            platform: z.ZodOptional<z.ZodString>;
+            arch: z.ZodOptional<z.ZodString>;
+            runtime: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            name?: string | undefined;
+            backend?: string | undefined;
+            mode?: string | undefined;
+            platform?: string | undefined;
+            arch?: string | undefined;
+            runtime?: string | undefined;
+        }, {
+            name?: string | undefined;
+            backend?: string | undefined;
+            mode?: string | undefined;
+            platform?: string | undefined;
+            arch?: string | undefined;
+            runtime?: string | undefined;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        bootId: string;
+        version: string;
+        metadata?: {
+            name?: string | undefined;
+            backend?: string | undefined;
+            mode?: string | undefined;
+            platform?: string | undefined;
+            arch?: string | undefined;
+            runtime?: string | undefined;
+        } | undefined;
+    }, {
+        id: string;
+        bootId: string;
+        version: string;
+        metadata?: {
+            name?: string | undefined;
+            backend?: string | undefined;
+            mode?: string | undefined;
+            platform?: string | undefined;
+            arch?: string | undefined;
+            runtime?: string | undefined;
+        } | undefined;
+    }>;
+    events: z.ZodArray<z.ZodEffects<z.ZodObject<{
+        sequence: z.ZodNumber;
+        id: z.ZodString;
+        occurredAt: z.ZodString;
+        type: z.ZodString;
+        level: z.ZodOptional<z.ZodEnum<["debug", "info", "warn", "error"]>>;
+        runId: z.ZodOptional<z.ZodString>;
+        phase: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodEnum<["queued", "running", "waiting", "blocked", "succeeded", "failed", "cancelled"]>>;
+        run: z.ZodOptional<z.ZodObject<{
+            source: z.ZodOptional<z.ZodString>;
+            repository: z.ZodOptional<z.ZodString>;
+            issueKey: z.ZodOptional<z.ZodString>;
+            recipe: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            source?: string | undefined;
+            repository?: string | undefined;
+            issueKey?: string | undefined;
+            recipe?: string | undefined;
+        }, {
+            source?: string | undefined;
+            repository?: string | undefined;
+            issueKey?: string | undefined;
+            recipe?: string | undefined;
+        }>>;
+        attributes: z.ZodOptional<z.ZodObject<{
+            backend: z.ZodOptional<z.ZodString>;
+            mode: z.ZodOptional<z.ZodString>;
+            component: z.ZodOptional<z.ZodString>;
+            operation: z.ZodOptional<z.ZodString>;
+            errorClass: z.ZodOptional<z.ZodString>;
+            errorCode: z.ZodOptional<z.ZodString>;
+            errorFingerprint: z.ZodOptional<z.ZodString>;
+            retryable: z.ZodOptional<z.ZodBoolean>;
+            attempt: z.ZodOptional<z.ZodNumber>;
+            durationMs: z.ZodOptional<z.ZodNumber>;
+            agentRole: z.ZodOptional<z.ZodString>;
+            invocationId: z.ZodOptional<z.ZodString>;
+            nodeId: z.ZodOptional<z.ZodString>;
+            previousPhase: z.ZodOptional<z.ZodString>;
+            releaseReason: z.ZodOptional<z.ZodEnum<["completed", "human_review", "factory_stopped", "waiting_for_human", "exited", "offline", "node_offline", "crashed", "reconciled_missing", "delivery_failed", "dispatch_failed", "source_state_changed", "other"]>>;
+            cancellationReason: z.ZodOptional<z.ZodEnum<["source_state_changed", "agent_spawn_failed", "agent_delivery_failed", "dispatch_failed"]>>;
+            dryRun: z.ZodOptional<z.ZodBoolean>;
+            count: z.ZodOptional<z.ZodNumber>;
+            activeRuns: z.ZodOptional<z.ZodNumber>;
+            queuedRuns: z.ZodOptional<z.ZodNumber>;
+            trackedAgents: z.ZodOptional<z.ZodNumber>;
+            unownedAgents: z.ZodOptional<z.ZodNumber>;
+            outboxDepth: z.ZodOptional<z.ZodNumber>;
+            outboxOldestAgeMs: z.ZodOptional<z.ZodNumber>;
+            droppedEvents: z.ZodOptional<z.ZodNumber>;
+            transport: z.ZodOptional<z.ZodString>;
+            locality: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            transport?: string | undefined;
+            dryRun?: boolean | undefined;
+            backend?: string | undefined;
+            mode?: string | undefined;
+            component?: string | undefined;
+            operation?: string | undefined;
+            errorClass?: string | undefined;
+            errorCode?: string | undefined;
+            errorFingerprint?: string | undefined;
+            retryable?: boolean | undefined;
+            attempt?: number | undefined;
+            durationMs?: number | undefined;
+            agentRole?: string | undefined;
+            invocationId?: string | undefined;
+            nodeId?: string | undefined;
+            previousPhase?: string | undefined;
+            releaseReason?: "completed" | "human_review" | "factory_stopped" | "waiting_for_human" | "exited" | "offline" | "node_offline" | "crashed" | "reconciled_missing" | "delivery_failed" | "dispatch_failed" | "source_state_changed" | "other" | undefined;
+            cancellationReason?: "dispatch_failed" | "source_state_changed" | "agent_spawn_failed" | "agent_delivery_failed" | undefined;
+            count?: number | undefined;
+            activeRuns?: number | undefined;
+            queuedRuns?: number | undefined;
+            trackedAgents?: number | undefined;
+            unownedAgents?: number | undefined;
+            outboxDepth?: number | undefined;
+            outboxOldestAgeMs?: number | undefined;
+            droppedEvents?: number | undefined;
+            locality?: string | undefined;
+        }, {
+            transport?: string | undefined;
+            dryRun?: boolean | undefined;
+            backend?: string | undefined;
+            mode?: string | undefined;
+            component?: string | undefined;
+            operation?: string | undefined;
+            errorClass?: string | undefined;
+            errorCode?: string | undefined;
+            errorFingerprint?: string | undefined;
+            retryable?: boolean | undefined;
+            attempt?: number | undefined;
+            durationMs?: number | undefined;
+            agentRole?: string | undefined;
+            invocationId?: string | undefined;
+            nodeId?: string | undefined;
+            previousPhase?: string | undefined;
+            releaseReason?: "completed" | "human_review" | "factory_stopped" | "waiting_for_human" | "exited" | "offline" | "node_offline" | "crashed" | "reconciled_missing" | "delivery_failed" | "dispatch_failed" | "source_state_changed" | "other" | undefined;
+            cancellationReason?: "dispatch_failed" | "source_state_changed" | "agent_spawn_failed" | "agent_delivery_failed" | undefined;
+            count?: number | undefined;
+            activeRuns?: number | undefined;
+            queuedRuns?: number | undefined;
+            trackedAgents?: number | undefined;
+            unownedAgents?: number | undefined;
+            outboxDepth?: number | undefined;
+            outboxOldestAgeMs?: number | undefined;
+            droppedEvents?: number | undefined;
+            locality?: string | undefined;
+        }>>;
+        trace: z.ZodOptional<z.ZodObject<{
+            traceId: z.ZodEffects<z.ZodString, string, string>;
+            spanId: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+            parentSpanId: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        }, "strict", z.ZodTypeAny, {
+            traceId: string;
+            spanId?: string | undefined;
+            parentSpanId?: string | undefined;
+        }, {
+            traceId: string;
+            spanId?: string | undefined;
+            parentSpanId?: string | undefined;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        type: string;
+        id: string;
+        occurredAt: string;
+        sequence: number;
+        status?: "blocked" | "failed" | "queued" | "running" | "waiting" | "succeeded" | "cancelled" | undefined;
+        level?: "debug" | "info" | "warn" | "error" | undefined;
+        runId?: string | undefined;
+        phase?: string | undefined;
+        run?: {
+            source?: string | undefined;
+            repository?: string | undefined;
+            issueKey?: string | undefined;
+            recipe?: string | undefined;
+        } | undefined;
+        attributes?: {
+            transport?: string | undefined;
+            dryRun?: boolean | undefined;
+            backend?: string | undefined;
+            mode?: string | undefined;
+            component?: string | undefined;
+            operation?: string | undefined;
+            errorClass?: string | undefined;
+            errorCode?: string | undefined;
+            errorFingerprint?: string | undefined;
+            retryable?: boolean | undefined;
+            attempt?: number | undefined;
+            durationMs?: number | undefined;
+            agentRole?: string | undefined;
+            invocationId?: string | undefined;
+            nodeId?: string | undefined;
+            previousPhase?: string | undefined;
+            releaseReason?: "completed" | "human_review" | "factory_stopped" | "waiting_for_human" | "exited" | "offline" | "node_offline" | "crashed" | "reconciled_missing" | "delivery_failed" | "dispatch_failed" | "source_state_changed" | "other" | undefined;
+            cancellationReason?: "dispatch_failed" | "source_state_changed" | "agent_spawn_failed" | "agent_delivery_failed" | undefined;
+            count?: number | undefined;
+            activeRuns?: number | undefined;
+            queuedRuns?: number | undefined;
+            trackedAgents?: number | undefined;
+            unownedAgents?: number | undefined;
+            outboxDepth?: number | undefined;
+            outboxOldestAgeMs?: number | undefined;
+            droppedEvents?: number | undefined;
+            locality?: string | undefined;
+        } | undefined;
+        trace?: {
+            traceId: string;
+            spanId?: string | undefined;
+            parentSpanId?: string | undefined;
+        } | undefined;
+    }, {
+        type: string;
+        id: string;
+        occurredAt: string;
+        sequence: number;
+        status?: "blocked" | "failed" | "queued" | "running" | "waiting" | "succeeded" | "cancelled" | undefined;
+        level?: "debug" | "info" | "warn" | "error" | undefined;
+        runId?: string | undefined;
+        phase?: string | undefined;
+        run?: {
+            source?: string | undefined;
+            repository?: string | undefined;
+            issueKey?: string | undefined;
+            recipe?: string | undefined;
+        } | undefined;
+        attributes?: {
+            transport?: string | undefined;
+            dryRun?: boolean | undefined;
+            backend?: string | undefined;
+            mode?: string | undefined;
+            component?: string | undefined;
+            operation?: string | undefined;
+            errorClass?: string | undefined;
+            errorCode?: string | undefined;
+            errorFingerprint?: string | undefined;
+            retryable?: boolean | undefined;
+            attempt?: number | undefined;
+            durationMs?: number | undefined;
+            agentRole?: string | undefined;
+            invocationId?: string | undefined;
+            nodeId?: string | undefined;
+            previousPhase?: string | undefined;
+            releaseReason?: "completed" | "human_review" | "factory_stopped" | "waiting_for_human" | "exited" | "offline" | "node_offline" | "crashed" | "reconciled_missing" | "delivery_failed" | "dispatch_failed" | "source_state_changed" | "other" | undefined;
+            cancellationReason?: "dispatch_failed" | "source_state_changed" | "agent_spawn_failed" | "agent_delivery_failed" | undefined;
+            count?: number | undefined;
+            activeRuns?: number | undefined;
+            queuedRuns?: number | undefined;
+            trackedAgents?: number | undefined;
+            unownedAgents?: number | undefined;
+            outboxDepth?: number | undefined;
+            outboxOldestAgeMs?: number | undefined;
+            droppedEvents?: number | undefined;
+            locality?: string | undefined;
+        } | undefined;
+        trace?: {
+            traceId: string;
+            spanId?: string | undefined;
+            parentSpanId?: string | undefined;
+        } | undefined;
+    }>, {
+        type: string;
+        id: string;
+        occurredAt: string;
+        sequence: number;
+        status?: "blocked" | "failed" | "queued" | "running" | "waiting" | "succeeded" | "cancelled" | undefined;
+        level?: "debug" | "info" | "warn" | "error" | undefined;
+        runId?: string | undefined;
+        phase?: string | undefined;
+        run?: {
+            source?: string | undefined;
+            repository?: string | undefined;
+            issueKey?: string | undefined;
+            recipe?: string | undefined;
+        } | undefined;
+        attributes?: {
+            transport?: string | undefined;
+            dryRun?: boolean | undefined;
+            backend?: string | undefined;
+            mode?: string | undefined;
+            component?: string | undefined;
+            operation?: string | undefined;
+            errorClass?: string | undefined;
+            errorCode?: string | undefined;
+            errorFingerprint?: string | undefined;
+            retryable?: boolean | undefined;
+            attempt?: number | undefined;
+            durationMs?: number | undefined;
+            agentRole?: string | undefined;
+            invocationId?: string | undefined;
+            nodeId?: string | undefined;
+            previousPhase?: string | undefined;
+            releaseReason?: "completed" | "human_review" | "factory_stopped" | "waiting_for_human" | "exited" | "offline" | "node_offline" | "crashed" | "reconciled_missing" | "delivery_failed" | "dispatch_failed" | "source_state_changed" | "other" | undefined;
+            cancellationReason?: "dispatch_failed" | "source_state_changed" | "agent_spawn_failed" | "agent_delivery_failed" | undefined;
+            count?: number | undefined;
+            activeRuns?: number | undefined;
+            queuedRuns?: number | undefined;
+            trackedAgents?: number | undefined;
+            unownedAgents?: number | undefined;
+            outboxDepth?: number | undefined;
+            outboxOldestAgeMs?: number | undefined;
+            droppedEvents?: number | undefined;
+            locality?: string | undefined;
+        } | undefined;
+        trace?: {
+            traceId: string;
+            spanId?: string | undefined;
+            parentSpanId?: string | undefined;
+        } | undefined;
+    }, {
+        type: string;
+        id: string;
+        occurredAt: string;
+        sequence: number;
+        status?: "blocked" | "failed" | "queued" | "running" | "waiting" | "succeeded" | "cancelled" | undefined;
+        level?: "debug" | "info" | "warn" | "error" | undefined;
+        runId?: string | undefined;
+        phase?: string | undefined;
+        run?: {
+            source?: string | undefined;
+            repository?: string | undefined;
+            issueKey?: string | undefined;
+            recipe?: string | undefined;
+        } | undefined;
+        attributes?: {
+            transport?: string | undefined;
+            dryRun?: boolean | undefined;
+            backend?: string | undefined;
+            mode?: string | undefined;
+            component?: string | undefined;
+            operation?: string | undefined;
+            errorClass?: string | undefined;
+            errorCode?: string | undefined;
+            errorFingerprint?: string | undefined;
+            retryable?: boolean | undefined;
+            attempt?: number | undefined;
+            durationMs?: number | undefined;
+            agentRole?: string | undefined;
+            invocationId?: string | undefined;
+            nodeId?: string | undefined;
+            previousPhase?: string | undefined;
+            releaseReason?: "completed" | "human_review" | "factory_stopped" | "waiting_for_human" | "exited" | "offline" | "node_offline" | "crashed" | "reconciled_missing" | "delivery_failed" | "dispatch_failed" | "source_state_changed" | "other" | undefined;
+            cancellationReason?: "dispatch_failed" | "source_state_changed" | "agent_spawn_failed" | "agent_delivery_failed" | undefined;
+            count?: number | undefined;
+            activeRuns?: number | undefined;
+            queuedRuns?: number | undefined;
+            trackedAgents?: number | undefined;
+            unownedAgents?: number | undefined;
+            outboxDepth?: number | undefined;
+            outboxOldestAgeMs?: number | undefined;
+            droppedEvents?: number | undefined;
+            locality?: string | undefined;
+        } | undefined;
+        trace?: {
+            traceId: string;
+            spanId?: string | undefined;
+            parentSpanId?: string | undefined;
+        } | undefined;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    contract: "factory.telemetry.v1";
+    instance: {
+        id: string;
+        bootId: string;
+        version: string;
+        metadata?: {
+            name?: string | undefined;
+            backend?: string | undefined;
+            mode?: string | undefined;
+            platform?: string | undefined;
+            arch?: string | undefined;
+            runtime?: string | undefined;
+        } | undefined;
+    };
+    events: {
+        type: string;
+        id: string;
+        occurredAt: string;
+        sequence: number;
+        status?: "blocked" | "failed" | "queued" | "running" | "waiting" | "succeeded" | "cancelled" | undefined;
+        level?: "debug" | "info" | "warn" | "error" | undefined;
+        runId?: string | undefined;
+        phase?: string | undefined;
+        run?: {
+            source?: string | undefined;
+            repository?: string | undefined;
+            issueKey?: string | undefined;
+            recipe?: string | undefined;
+        } | undefined;
+        attributes?: {
+            transport?: string | undefined;
+            dryRun?: boolean | undefined;
+            backend?: string | undefined;
+            mode?: string | undefined;
+            component?: string | undefined;
+            operation?: string | undefined;
+            errorClass?: string | undefined;
+            errorCode?: string | undefined;
+            errorFingerprint?: string | undefined;
+            retryable?: boolean | undefined;
+            attempt?: number | undefined;
+            durationMs?: number | undefined;
+            agentRole?: string | undefined;
+            invocationId?: string | undefined;
+            nodeId?: string | undefined;
+            previousPhase?: string | undefined;
+            releaseReason?: "completed" | "human_review" | "factory_stopped" | "waiting_for_human" | "exited" | "offline" | "node_offline" | "crashed" | "reconciled_missing" | "delivery_failed" | "dispatch_failed" | "source_state_changed" | "other" | undefined;
+            cancellationReason?: "dispatch_failed" | "source_state_changed" | "agent_spawn_failed" | "agent_delivery_failed" | undefined;
+            count?: number | undefined;
+            activeRuns?: number | undefined;
+            queuedRuns?: number | undefined;
+            trackedAgents?: number | undefined;
+            unownedAgents?: number | undefined;
+            outboxDepth?: number | undefined;
+            outboxOldestAgeMs?: number | undefined;
+            droppedEvents?: number | undefined;
+            locality?: string | undefined;
+        } | undefined;
+        trace?: {
+            traceId: string;
+            spanId?: string | undefined;
+            parentSpanId?: string | undefined;
+        } | undefined;
+    }[];
+}, {
+    contract: "factory.telemetry.v1";
+    instance: {
+        id: string;
+        bootId: string;
+        version: string;
+        metadata?: {
+            name?: string | undefined;
+            backend?: string | undefined;
+            mode?: string | undefined;
+            platform?: string | undefined;
+            arch?: string | undefined;
+            runtime?: string | undefined;
+        } | undefined;
+    };
+    events: {
+        type: string;
+        id: string;
+        occurredAt: string;
+        sequence: number;
+        status?: "blocked" | "failed" | "queued" | "running" | "waiting" | "succeeded" | "cancelled" | undefined;
+        level?: "debug" | "info" | "warn" | "error" | undefined;
+        runId?: string | undefined;
+        phase?: string | undefined;
+        run?: {
+            source?: string | undefined;
+            repository?: string | undefined;
+            issueKey?: string | undefined;
+            recipe?: string | undefined;
+        } | undefined;
+        attributes?: {
+            transport?: string | undefined;
+            dryRun?: boolean | undefined;
+            backend?: string | undefined;
+            mode?: string | undefined;
+            component?: string | undefined;
+            operation?: string | undefined;
+            errorClass?: string | undefined;
+            errorCode?: string | undefined;
+            errorFingerprint?: string | undefined;
+            retryable?: boolean | undefined;
+            attempt?: number | undefined;
+            durationMs?: number | undefined;
+            agentRole?: string | undefined;
+            invocationId?: string | undefined;
+            nodeId?: string | undefined;
+            previousPhase?: string | undefined;
+            releaseReason?: "completed" | "human_review" | "factory_stopped" | "waiting_for_human" | "exited" | "offline" | "node_offline" | "crashed" | "reconciled_missing" | "delivery_failed" | "dispatch_failed" | "source_state_changed" | "other" | undefined;
+            cancellationReason?: "dispatch_failed" | "source_state_changed" | "agent_spawn_failed" | "agent_delivery_failed" | undefined;
+            count?: number | undefined;
+            activeRuns?: number | undefined;
+            queuedRuns?: number | undefined;
+            trackedAgents?: number | undefined;
+            unownedAgents?: number | undefined;
+            outboxDepth?: number | undefined;
+            outboxOldestAgeMs?: number | undefined;
+            droppedEvents?: number | undefined;
+            locality?: string | undefined;
+        } | undefined;
+        trace?: {
+            traceId: string;
+            spanId?: string | undefined;
+            parentSpanId?: string | undefined;
+        } | undefined;
+    }[];
+}>;
+export type FactoryCloudEventBatchV1 = z.infer<typeof FactoryCloudEventBatchV1Schema>;
+export interface CreateFactoryCloudEventV1Options {
+    id?: () => string;
+    now?: () => Date;
+}
+/**
+ * Stable correlation ID for the durable run. It has W3C trace-id shape but is
+ * not evidence that an OpenTelemetry span was created or exported.
+ */
+export declare function factoryRunTraceIdV1(runId: string): string;
+export declare function createFactoryCloudEventV1(input: Omit<FactoryCloudEventInputV1, 'id' | 'occurredAt'> & Partial<Pick<FactoryCloudEventInputV1, 'id' | 'occurredAt'>>, options?: CreateFactoryCloudEventV1Options): FactoryCloudEventInputV1;
+/**
+ * Converts provider-owned exit/release text into a closed operational category.
+ * Unknown text is never forwarded because it can contain task or error details.
+ */
+export declare function factoryCloudReleaseReasonV1(value: string | undefined): FactoryCloudReleaseReasonV1 | undefined;
+export declare function isCriticalFactoryCloudEvent(event: Pick<FactoryCloudEventInputV1, 'type' | 'level' | 'status'>): boolean;
+//# sourceMappingURL=events.d.ts.map