@ai-dev-orchestrator/schemas 0.1.1

package/dist/workflow/workflow-journal.d.ts

@@ -0,0 +1,520 @@
+import { z } from 'zod/v4';
+export declare const JOURNAL_EVENT_TYPES: readonly ["run_started", "run_completed", "run_failed", "run_aborted", "run_resumed", "state_transition", "worker_dispatched", "worker_completed", "worker_failed", "worker_retried", "script_started", "script_completed", "artifact_stored", "artifact_staleness_detected", "governance_decision", "agreement_produced", "escalation", "finding_raised", "finding_resolved", "human_input_requested", "human_input_received", "human_approval", "human_rejection", "error", "model_escalation"];
+export declare const journalEventTypeSchema: z.ZodEnum<{
+    error: "error";
+    escalation: "escalation";
+    run_started: "run_started";
+    run_completed: "run_completed";
+    run_failed: "run_failed";
+    run_aborted: "run_aborted";
+    run_resumed: "run_resumed";
+    state_transition: "state_transition";
+    worker_dispatched: "worker_dispatched";
+    worker_completed: "worker_completed";
+    worker_failed: "worker_failed";
+    worker_retried: "worker_retried";
+    script_started: "script_started";
+    script_completed: "script_completed";
+    artifact_stored: "artifact_stored";
+    artifact_staleness_detected: "artifact_staleness_detected";
+    governance_decision: "governance_decision";
+    agreement_produced: "agreement_produced";
+    finding_raised: "finding_raised";
+    finding_resolved: "finding_resolved";
+    human_input_requested: "human_input_requested";
+    human_input_received: "human_input_received";
+    human_approval: "human_approval";
+    human_rejection: "human_rejection";
+    model_escalation: "model_escalation";
+}>;
+export type JournalEventType = z.infer<typeof journalEventTypeSchema>;
+export declare const runLifecycleDataSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"run_lifecycle">;
+    workflowName: z.ZodString;
+    workflowVersion: z.ZodString;
+    status: z.ZodOptional<z.ZodString>;
+    reason: z.ZodOptional<z.ZodString>;
+    finalState: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type RunLifecycleData = z.infer<typeof runLifecycleDataSchema>;
+export declare const stateTransitionDataSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"state_transition">;
+    from: z.ZodString;
+    to: z.ZodString;
+    trigger: z.ZodEnum<{
+        timeout: "timeout";
+        failure: "failure";
+        completion: "completion";
+        review_approved: "review_approved";
+        review_rejected: "review_rejected";
+        iteration_exhausted: "iteration_exhausted";
+        judge_approved: "judge_approved";
+        judge_rejected: "judge_rejected";
+        escalation: "escalation";
+        human_input: "human_input";
+        human_approved: "human_approved";
+        human_rejected: "human_rejected";
+    }>;
+    durationMs: z.ZodNumber;
+    guardsEvaluated: z.ZodNumber;
+    guardsPassed: z.ZodNumber;
+    governanceRequired: z.ZodBoolean;
+    governanceOutcome: z.ZodOptional<z.ZodEnum<{
+        allowed: "allowed";
+        denied: "denied";
+        escalated: "escalated";
+    }>>;
+    contractId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type StateTransitionData = z.infer<typeof stateTransitionDataSchema>;
+export declare const workerEventDataSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"worker">;
+    workerId: z.ZodString;
+    role: z.ZodString;
+    stateId: z.ZodString;
+    status: z.ZodString;
+    inputTokens: z.ZodOptional<z.ZodNumber>;
+    outputTokens: z.ZodOptional<z.ZodNumber>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    error: z.ZodOptional<z.ZodString>;
+    retryCount: z.ZodOptional<z.ZodNumber>;
+    outputArtifacts: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            intake_requirements: "intake_requirements";
+            canonical_specification: "canonical_specification";
+            clarification_questions: "clarification_questions";
+            clarification_answers: "clarification_answers";
+            plan: "plan";
+            plan_review: "plan_review";
+            test_plan: "test_plan";
+            implementation: "implementation";
+            static_review: "static_review";
+            security_review: "security_review";
+            performance_review: "performance_review";
+            adversarial_review: "adversarial_review";
+            design_review: "design_review";
+            docs_review: "docs_review";
+            ux_review: "ux_review";
+            review_report: "review_report";
+            remediation_plan: "remediation_plan";
+            verification: "verification";
+            judge_decision: "judge_decision";
+            planning_agreement: "planning_agreement";
+            implementation_agreement: "implementation_agreement";
+            verification_agreement: "verification_agreement";
+            release_summary: "release_summary";
+            release_agreement: "release_agreement";
+            escalation_context: "escalation_context";
+            run_manifest: "run_manifest";
+            codebase_context: "codebase_context";
+            test_suite: "test_suite";
+            acceptance_validation: "acceptance_validation";
+            review_findings: "review_findings";
+            task_breakdown: "task_breakdown";
+            decomposition_review: "decomposition_review";
+            task_specifications: "task_specifications";
+            pr_diff_context: "pr_diff_context";
+        }>;
+        name: z.ZodString;
+        version: z.ZodNumber;
+        checksum: z.ZodString;
+    }, z.core.$strip>>>>;
+}, z.core.$strip>;
+export type WorkerEventData = z.infer<typeof workerEventDataSchema>;
+export declare const artifactEventDataSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"artifact">;
+    artifactRef: z.ZodObject<{
+        type: z.ZodEnum<{
+            intake_requirements: "intake_requirements";
+            canonical_specification: "canonical_specification";
+            clarification_questions: "clarification_questions";
+            clarification_answers: "clarification_answers";
+            plan: "plan";
+            plan_review: "plan_review";
+            test_plan: "test_plan";
+            implementation: "implementation";
+            static_review: "static_review";
+            security_review: "security_review";
+            performance_review: "performance_review";
+            adversarial_review: "adversarial_review";
+            design_review: "design_review";
+            docs_review: "docs_review";
+            ux_review: "ux_review";
+            review_report: "review_report";
+            remediation_plan: "remediation_plan";
+            verification: "verification";
+            judge_decision: "judge_decision";
+            planning_agreement: "planning_agreement";
+            implementation_agreement: "implementation_agreement";
+            verification_agreement: "verification_agreement";
+            release_summary: "release_summary";
+            release_agreement: "release_agreement";
+            escalation_context: "escalation_context";
+            run_manifest: "run_manifest";
+            codebase_context: "codebase_context";
+            test_suite: "test_suite";
+            acceptance_validation: "acceptance_validation";
+            review_findings: "review_findings";
+            task_breakdown: "task_breakdown";
+            decomposition_review: "decomposition_review";
+            task_specifications: "task_specifications";
+            pr_diff_context: "pr_diff_context";
+        }>;
+        name: z.ZodString;
+        version: z.ZodNumber;
+        checksum: z.ZodString;
+    }, z.core.$strip>;
+    producedBy: z.ZodString;
+    sizeBytes: z.ZodNumber;
+}, z.core.$strip>;
+export type ArtifactEventData = z.infer<typeof artifactEventDataSchema>;
+export declare const governanceEventDataSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"governance">;
+    outcome: z.ZodEnum<{
+        allowed: "allowed";
+        denied: "denied";
+        escalated: "escalated";
+    }>;
+    reason: z.ZodString;
+    transitionFrom: z.ZodOptional<z.ZodString>;
+    transitionTo: z.ZodOptional<z.ZodString>;
+    policiesEvaluated: z.ZodOptional<z.ZodNumber>;
+    agreementType: z.ZodOptional<z.ZodString>;
+    escalationReason: z.ZodOptional<z.ZodEnum<{
+        iteration_limit_exceeded: "iteration_limit_exceeded";
+        quality_gate_failed: "quality_gate_failed";
+        unresolvable_conflict: "unresolvable_conflict";
+        human_requested: "human_requested";
+        token_budget_exceeded: "token_budget_exceeded";
+        retry_limit_exceeded: "retry_limit_exceeded";
+        confidence_too_low: "confidence_too_low";
+    }>>;
+}, z.core.$strip>;
+export type GovernanceEventData = z.infer<typeof governanceEventDataSchema>;
+export declare const findingEventDataSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"finding">;
+    findingId: z.ZodString;
+    severity: z.ZodString;
+    status: z.ZodString;
+    title: z.ZodString;
+    blocking: z.ZodString;
+    resolvedBy: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type FindingEventData = z.infer<typeof findingEventDataSchema>;
+export declare const humanEventDataSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"human">;
+    action: z.ZodString;
+    stateId: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+    inputType: z.ZodOptional<z.ZodString>;
+    approvedBy: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type HumanEventData = z.infer<typeof humanEventDataSchema>;
+export declare const errorDataSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"error">;
+    errorCode: z.ZodString;
+    message: z.ZodString;
+    stateId: z.ZodOptional<z.ZodString>;
+    recoverable: z.ZodBoolean;
+}, z.core.$strip>;
+export type ErrorData = z.infer<typeof errorDataSchema>;
+export declare const artifactStalenessDataSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"artifact_staleness">;
+    trigger: z.ZodString;
+    staleCount: z.ZodNumber;
+    rebuildOrder: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type ArtifactStalenessData = z.infer<typeof artifactStalenessDataSchema>;
+export declare const modelEscalationDataSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"model_escalation">;
+    fromModel: z.ZodString;
+    toModel: z.ZodString;
+    roleId: z.ZodString;
+    confidenceScore: z.ZodNumber;
+    heuristicScore: z.ZodNumber;
+    finalScore: z.ZodNumber;
+}, z.core.$strip>;
+export type ModelEscalationData = z.infer<typeof modelEscalationDataSchema>;
+export declare const scriptEventDataSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"script">;
+    script: z.ZodString;
+    stateId: z.ZodString;
+    exitCode: z.ZodOptional<z.ZodNumber>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    stdout: z.ZodOptional<z.ZodString>;
+    stderr: z.ZodOptional<z.ZodString>;
+    success: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type ScriptEventData = z.infer<typeof scriptEventDataSchema>;
+export declare const journalEventDataSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"run_lifecycle">;
+    workflowName: z.ZodString;
+    workflowVersion: z.ZodString;
+    status: z.ZodOptional<z.ZodString>;
+    reason: z.ZodOptional<z.ZodString>;
+    finalState: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"state_transition">;
+    from: z.ZodString;
+    to: z.ZodString;
+    trigger: z.ZodEnum<{
+        timeout: "timeout";
+        failure: "failure";
+        completion: "completion";
+        review_approved: "review_approved";
+        review_rejected: "review_rejected";
+        iteration_exhausted: "iteration_exhausted";
+        judge_approved: "judge_approved";
+        judge_rejected: "judge_rejected";
+        escalation: "escalation";
+        human_input: "human_input";
+        human_approved: "human_approved";
+        human_rejected: "human_rejected";
+    }>;
+    durationMs: z.ZodNumber;
+    guardsEvaluated: z.ZodNumber;
+    guardsPassed: z.ZodNumber;
+    governanceRequired: z.ZodBoolean;
+    governanceOutcome: z.ZodOptional<z.ZodEnum<{
+        allowed: "allowed";
+        denied: "denied";
+        escalated: "escalated";
+    }>>;
+    contractId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"worker">;
+    workerId: z.ZodString;
+    role: z.ZodString;
+    stateId: z.ZodString;
+    status: z.ZodString;
+    inputTokens: z.ZodOptional<z.ZodNumber>;
+    outputTokens: z.ZodOptional<z.ZodNumber>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    error: z.ZodOptional<z.ZodString>;
+    retryCount: z.ZodOptional<z.ZodNumber>;
+    outputArtifacts: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            intake_requirements: "intake_requirements";
+            canonical_specification: "canonical_specification";
+            clarification_questions: "clarification_questions";
+            clarification_answers: "clarification_answers";
+            plan: "plan";
+            plan_review: "plan_review";
+            test_plan: "test_plan";
+            implementation: "implementation";
+            static_review: "static_review";
+            security_review: "security_review";
+            performance_review: "performance_review";
+            adversarial_review: "adversarial_review";
+            design_review: "design_review";
+            docs_review: "docs_review";
+            ux_review: "ux_review";
+            review_report: "review_report";
+            remediation_plan: "remediation_plan";
+            verification: "verification";
+            judge_decision: "judge_decision";
+            planning_agreement: "planning_agreement";
+            implementation_agreement: "implementation_agreement";
+            verification_agreement: "verification_agreement";
+            release_summary: "release_summary";
+            release_agreement: "release_agreement";
+            escalation_context: "escalation_context";
+            run_manifest: "run_manifest";
+            codebase_context: "codebase_context";
+            test_suite: "test_suite";
+            acceptance_validation: "acceptance_validation";
+            review_findings: "review_findings";
+            task_breakdown: "task_breakdown";
+            decomposition_review: "decomposition_review";
+            task_specifications: "task_specifications";
+            pr_diff_context: "pr_diff_context";
+        }>;
+        name: z.ZodString;
+        version: z.ZodNumber;
+        checksum: z.ZodString;
+    }, z.core.$strip>>>>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"artifact">;
+    artifactRef: z.ZodObject<{
+        type: z.ZodEnum<{
+            intake_requirements: "intake_requirements";
+            canonical_specification: "canonical_specification";
+            clarification_questions: "clarification_questions";
+            clarification_answers: "clarification_answers";
+            plan: "plan";
+            plan_review: "plan_review";
+            test_plan: "test_plan";
+            implementation: "implementation";
+            static_review: "static_review";
+            security_review: "security_review";
+            performance_review: "performance_review";
+            adversarial_review: "adversarial_review";
+            design_review: "design_review";
+            docs_review: "docs_review";
+            ux_review: "ux_review";
+            review_report: "review_report";
+            remediation_plan: "remediation_plan";
+            verification: "verification";
+            judge_decision: "judge_decision";
+            planning_agreement: "planning_agreement";
+            implementation_agreement: "implementation_agreement";
+            verification_agreement: "verification_agreement";
+            release_summary: "release_summary";
+            release_agreement: "release_agreement";
+            escalation_context: "escalation_context";
+            run_manifest: "run_manifest";
+            codebase_context: "codebase_context";
+            test_suite: "test_suite";
+            acceptance_validation: "acceptance_validation";
+            review_findings: "review_findings";
+            task_breakdown: "task_breakdown";
+            decomposition_review: "decomposition_review";
+            task_specifications: "task_specifications";
+            pr_diff_context: "pr_diff_context";
+        }>;
+        name: z.ZodString;
+        version: z.ZodNumber;
+        checksum: z.ZodString;
+    }, z.core.$strip>;
+    producedBy: z.ZodString;
+    sizeBytes: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"governance">;
+    outcome: z.ZodEnum<{
+        allowed: "allowed";
+        denied: "denied";
+        escalated: "escalated";
+    }>;
+    reason: z.ZodString;
+    transitionFrom: z.ZodOptional<z.ZodString>;
+    transitionTo: z.ZodOptional<z.ZodString>;
+    policiesEvaluated: z.ZodOptional<z.ZodNumber>;
+    agreementType: z.ZodOptional<z.ZodString>;
+    escalationReason: z.ZodOptional<z.ZodEnum<{
+        iteration_limit_exceeded: "iteration_limit_exceeded";
+        quality_gate_failed: "quality_gate_failed";
+        unresolvable_conflict: "unresolvable_conflict";
+        human_requested: "human_requested";
+        token_budget_exceeded: "token_budget_exceeded";
+        retry_limit_exceeded: "retry_limit_exceeded";
+        confidence_too_low: "confidence_too_low";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"finding">;
+    findingId: z.ZodString;
+    severity: z.ZodString;
+    status: z.ZodString;
+    title: z.ZodString;
+    blocking: z.ZodString;
+    resolvedBy: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"human">;
+    action: z.ZodString;
+    stateId: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+    inputType: z.ZodOptional<z.ZodString>;
+    approvedBy: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"error">;
+    errorCode: z.ZodString;
+    message: z.ZodString;
+    stateId: z.ZodOptional<z.ZodString>;
+    recoverable: z.ZodBoolean;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"artifact_staleness">;
+    trigger: z.ZodString;
+    staleCount: z.ZodNumber;
+    rebuildOrder: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"script">;
+    script: z.ZodString;
+    stateId: z.ZodString;
+    exitCode: z.ZodOptional<z.ZodNumber>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    stdout: z.ZodOptional<z.ZodString>;
+    stderr: z.ZodOptional<z.ZodString>;
+    success: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"model_escalation">;
+    fromModel: z.ZodString;
+    toModel: z.ZodString;
+    roleId: z.ZodString;
+    confidenceScore: z.ZodNumber;
+    heuristicScore: z.ZodNumber;
+    finalScore: z.ZodNumber;
+}, z.core.$strip>], "kind">;
+export type JournalEventData = z.infer<typeof journalEventDataSchema>;
+/** Mapped type -- cannot be expressed as Zod schema. */
+export interface JournalEventMap {
+    run_started: RunLifecycleData;
+    run_completed: RunLifecycleData;
+    run_failed: RunLifecycleData;
+    run_aborted: RunLifecycleData;
+    run_resumed: RunLifecycleData;
+    state_transition: StateTransitionData;
+    worker_dispatched: WorkerEventData;
+    worker_completed: WorkerEventData;
+    worker_failed: WorkerEventData;
+    worker_retried: WorkerEventData;
+    script_started: ScriptEventData;
+    script_completed: ScriptEventData;
+    artifact_stored: ArtifactEventData;
+    artifact_staleness_detected: ArtifactStalenessData;
+    governance_decision: GovernanceEventData;
+    agreement_produced: GovernanceEventData;
+    escalation: GovernanceEventData;
+    finding_raised: FindingEventData;
+    finding_resolved: FindingEventData;
+    human_input_requested: HumanEventData;
+    human_input_received: HumanEventData;
+    human_approval: HumanEventData;
+    human_rejection: HumanEventData;
+    error: ErrorData;
+    model_escalation: ModelEscalationData;
+}
+/** Mapped type -- cannot be expressed as Zod schema. */
+export type JournalEvent = {
+    [K in JournalEventType]: {
+        readonly timestamp: string;
+        readonly runId: string;
+        readonly sequence: number;
+        readonly type: K;
+        readonly data: JournalEventMap[K];
+    };
+}[JournalEventType];
+export declare const journalFilterSchema: z.ZodObject<{
+    eventType: z.ZodOptional<z.ZodEnum<{
+        error: "error";
+        escalation: "escalation";
+        run_started: "run_started";
+        run_completed: "run_completed";
+        run_failed: "run_failed";
+        run_aborted: "run_aborted";
+        run_resumed: "run_resumed";
+        state_transition: "state_transition";
+        worker_dispatched: "worker_dispatched";
+        worker_completed: "worker_completed";
+        worker_failed: "worker_failed";
+        worker_retried: "worker_retried";
+        script_started: "script_started";
+        script_completed: "script_completed";
+        artifact_stored: "artifact_stored";
+        artifact_staleness_detected: "artifact_staleness_detected";
+        governance_decision: "governance_decision";
+        agreement_produced: "agreement_produced";
+        finding_raised: "finding_raised";
+        finding_resolved: "finding_resolved";
+        human_input_requested: "human_input_requested";
+        human_input_received: "human_input_received";
+        human_approval: "human_approval";
+        human_rejection: "human_rejection";
+        model_escalation: "model_escalation";
+    }>>;
+    stateId: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+    after: z.ZodOptional<z.ZodString>;
+    before: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type JournalFilter = z.infer<typeof journalFilterSchema>;

package/dist/workflow/workflow-journal.js

@@ -0,0 +1,151 @@
+import { z } from 'zod/v4';
+import { artifactRefSchema } from '../artifacts/artifact-system';
+import { escalationReasonSchema, governanceOutcomeSchema } from '../governance/governance';
+import { transitionTriggerSchema } from './workflow-engine';
+export const JOURNAL_EVENT_TYPES = [
+    'run_started',
+    'run_completed',
+    'run_failed',
+    'run_aborted',
+    'run_resumed',
+    'state_transition',
+    'worker_dispatched',
+    'worker_completed',
+    'worker_failed',
+    'worker_retried',
+    'script_started',
+    'script_completed',
+    'artifact_stored',
+    'artifact_staleness_detected',
+    'governance_decision',
+    'agreement_produced',
+    'escalation',
+    'finding_raised',
+    'finding_resolved',
+    'human_input_requested',
+    'human_input_received',
+    'human_approval',
+    'human_rejection',
+    'error',
+    'model_escalation',
+];
+export const journalEventTypeSchema = z.enum(JOURNAL_EVENT_TYPES);
+export const runLifecycleDataSchema = z.object({
+    kind: z.literal('run_lifecycle'),
+    workflowName: z.string(),
+    workflowVersion: z.string(),
+    status: z.string().optional(),
+    reason: z.string().optional(),
+    finalState: z.string().optional(),
+});
+export const stateTransitionDataSchema = z.object({
+    kind: z.literal('state_transition'),
+    from: z.string(),
+    to: z.string(),
+    trigger: transitionTriggerSchema,
+    durationMs: z.number(),
+    guardsEvaluated: z.number(),
+    guardsPassed: z.number(),
+    governanceRequired: z.boolean(),
+    governanceOutcome: governanceOutcomeSchema.optional(),
+    contractId: z.string().optional(),
+});
+export const workerEventDataSchema = z.object({
+    kind: z.literal('worker'),
+    workerId: z.string(),
+    role: z.string(),
+    stateId: z.string(),
+    status: z.string(),
+    inputTokens: z.number().optional(),
+    outputTokens: z.number().optional(),
+    durationMs: z.number().optional(),
+    error: z.string().optional(),
+    retryCount: z.number().optional(),
+    outputArtifacts: z.array(artifactRefSchema).readonly().optional(),
+});
+export const artifactEventDataSchema = z.object({
+    kind: z.literal('artifact'),
+    artifactRef: artifactRefSchema,
+    producedBy: z.string(),
+    sizeBytes: z.number(),
+});
+export const governanceEventDataSchema = z.object({
+    kind: z.literal('governance'),
+    outcome: governanceOutcomeSchema,
+    reason: z.string(),
+    transitionFrom: z.string().optional(),
+    transitionTo: z.string().optional(),
+    policiesEvaluated: z.number().optional(),
+    agreementType: z.string().optional(),
+    escalationReason: escalationReasonSchema.optional(),
+});
+export const findingEventDataSchema = z.object({
+    kind: z.literal('finding'),
+    findingId: z.string(),
+    severity: z.string(),
+    status: z.string(),
+    title: z.string(),
+    blocking: z.string(),
+    resolvedBy: z.string().optional(),
+});
+export const humanEventDataSchema = z.object({
+    kind: z.literal('human'),
+    action: z.string(),
+    stateId: z.string(),
+    reason: z.string().optional(),
+    inputType: z.string().optional(),
+    approvedBy: z.string().optional(),
+    sessionId: z.string().optional(),
+});
+export const errorDataSchema = z.object({
+    kind: z.literal('error'),
+    errorCode: z.string(),
+    message: z.string(),
+    stateId: z.string().optional(),
+    recoverable: z.boolean(),
+});
+export const artifactStalenessDataSchema = z.object({
+    kind: z.literal('artifact_staleness'),
+    trigger: z.string(),
+    staleCount: z.number(),
+    rebuildOrder: z.array(z.string()).readonly(),
+});
+export const modelEscalationDataSchema = z.object({
+    kind: z.literal('model_escalation'),
+    fromModel: z.string(),
+    toModel: z.string(),
+    roleId: z.string(),
+    confidenceScore: z.number().min(0).max(1),
+    heuristicScore: z.number().min(0).max(1),
+    finalScore: z.number().min(0).max(1),
+});
+export const scriptEventDataSchema = z.object({
+    kind: z.literal('script'),
+    script: z.string(),
+    stateId: z.string(),
+    exitCode: z.number().optional(),
+    durationMs: z.number().optional(),
+    stdout: z.string().optional(),
+    stderr: z.string().optional(),
+    success: z.boolean().optional(),
+});
+export const journalEventDataSchema = z.discriminatedUnion('kind', [
+    runLifecycleDataSchema,
+    stateTransitionDataSchema,
+    workerEventDataSchema,
+    artifactEventDataSchema,
+    governanceEventDataSchema,
+    findingEventDataSchema,
+    humanEventDataSchema,
+    errorDataSchema,
+    artifactStalenessDataSchema,
+    scriptEventDataSchema,
+    modelEscalationDataSchema,
+]);
+export const journalFilterSchema = z.object({
+    eventType: journalEventTypeSchema.optional(),
+    stateId: z.string().optional(),
+    role: z.string().optional(),
+    after: z.string().optional(),
+    before: z.string().optional(),
+});