@herdctl/core 0.0.1

package/dist/state/schemas/fleet-state.d.ts

@@ -0,0 +1,249 @@
+/**
+ * Zod schemas for fleet state (state.yaml)
+ *
+ * Defines the schema for tracking fleet-wide state including agent status
+ */
+import { z } from "zod";
+/**
+ * Possible states for a schedule
+ */
+export declare const ScheduleStatusSchema: z.ZodEnum<["idle", "running", "disabled"]>;
+/**
+ * State information for a single schedule
+ */
+export declare const ScheduleStateSchema: z.ZodObject<{
+    /** ISO timestamp of when this schedule last ran */
+    last_run_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** ISO timestamp of when this schedule will next run */
+    next_run_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Current status of the schedule */
+    status: z.ZodDefault<z.ZodEnum<["idle", "running", "disabled"]>>;
+    /** Last error message if the schedule encountered an error */
+    last_error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    status: "idle" | "running" | "disabled";
+    last_run_at?: string | null | undefined;
+    next_run_at?: string | null | undefined;
+    last_error?: string | null | undefined;
+}, {
+    status?: "idle" | "running" | "disabled" | undefined;
+    last_run_at?: string | null | undefined;
+    next_run_at?: string | null | undefined;
+    last_error?: string | null | undefined;
+}>;
+/**
+ * Possible states for an agent
+ */
+export declare const AgentStatusSchema: z.ZodEnum<["idle", "running", "error"]>;
+/**
+ * State information for a single agent
+ */
+export declare const AgentStateSchema: z.ZodObject<{
+    /** Current status of the agent */
+    status: z.ZodDefault<z.ZodEnum<["idle", "running", "error"]>>;
+    /** ID of the currently running job, if any */
+    current_job: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** ID of the last completed job */
+    last_job: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Name of the schedule that will trigger the next run */
+    next_schedule: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** ISO timestamp of when the next scheduled run will occur */
+    next_trigger_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Docker container ID if running in container */
+    container_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Error message if status is 'error' */
+    error_message: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Map of schedule names to their state */
+    schedules: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        /** ISO timestamp of when this schedule last ran */
+        last_run_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** ISO timestamp of when this schedule will next run */
+        next_run_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Current status of the schedule */
+        status: z.ZodDefault<z.ZodEnum<["idle", "running", "disabled"]>>;
+        /** Last error message if the schedule encountered an error */
+        last_error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        status: "idle" | "running" | "disabled";
+        last_run_at?: string | null | undefined;
+        next_run_at?: string | null | undefined;
+        last_error?: string | null | undefined;
+    }, {
+        status?: "idle" | "running" | "disabled" | undefined;
+        last_run_at?: string | null | undefined;
+        next_run_at?: string | null | undefined;
+        last_error?: string | null | undefined;
+    }>>>;
+}, "strip", z.ZodTypeAny, {
+    status: "error" | "idle" | "running";
+    schedules?: Record<string, {
+        status: "idle" | "running" | "disabled";
+        last_run_at?: string | null | undefined;
+        next_run_at?: string | null | undefined;
+        last_error?: string | null | undefined;
+    }> | undefined;
+    current_job?: string | null | undefined;
+    last_job?: string | null | undefined;
+    next_schedule?: string | null | undefined;
+    next_trigger_at?: string | null | undefined;
+    container_id?: string | null | undefined;
+    error_message?: string | null | undefined;
+}, {
+    status?: "error" | "idle" | "running" | undefined;
+    schedules?: Record<string, {
+        status?: "idle" | "running" | "disabled" | undefined;
+        last_run_at?: string | null | undefined;
+        next_run_at?: string | null | undefined;
+        last_error?: string | null | undefined;
+    }> | undefined;
+    current_job?: string | null | undefined;
+    last_job?: string | null | undefined;
+    next_schedule?: string | null | undefined;
+    next_trigger_at?: string | null | undefined;
+    container_id?: string | null | undefined;
+    error_message?: string | null | undefined;
+}>;
+/**
+ * Fleet metadata stored in state.yaml
+ */
+export declare const FleetMetadataSchema: z.ZodObject<{
+    /** ISO timestamp of when the fleet was first started */
+    started_at: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    started_at?: string | undefined;
+}, {
+    started_at?: string | undefined;
+}>;
+/**
+ * Top-level fleet state schema (state.yaml)
+ */
+export declare const FleetStateSchema: z.ZodObject<{
+    /** Fleet metadata */
+    fleet: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        /** ISO timestamp of when the fleet was first started */
+        started_at: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        started_at?: string | undefined;
+    }, {
+        started_at?: string | undefined;
+    }>>>;
+    /** Map of agent names to their current state */
+    agents: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        /** Current status of the agent */
+        status: z.ZodDefault<z.ZodEnum<["idle", "running", "error"]>>;
+        /** ID of the currently running job, if any */
+        current_job: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** ID of the last completed job */
+        last_job: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Name of the schedule that will trigger the next run */
+        next_schedule: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** ISO timestamp of when the next scheduled run will occur */
+        next_trigger_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Docker container ID if running in container */
+        container_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Error message if status is 'error' */
+        error_message: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Map of schedule names to their state */
+        schedules: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            /** ISO timestamp of when this schedule last ran */
+            last_run_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            /** ISO timestamp of when this schedule will next run */
+            next_run_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            /** Current status of the schedule */
+            status: z.ZodDefault<z.ZodEnum<["idle", "running", "disabled"]>>;
+            /** Last error message if the schedule encountered an error */
+            last_error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            status: "idle" | "running" | "disabled";
+            last_run_at?: string | null | undefined;
+            next_run_at?: string | null | undefined;
+            last_error?: string | null | undefined;
+        }, {
+            status?: "idle" | "running" | "disabled" | undefined;
+            last_run_at?: string | null | undefined;
+            next_run_at?: string | null | undefined;
+            last_error?: string | null | undefined;
+        }>>>;
+    }, "strip", z.ZodTypeAny, {
+        status: "error" | "idle" | "running";
+        schedules?: Record<string, {
+            status: "idle" | "running" | "disabled";
+            last_run_at?: string | null | undefined;
+            next_run_at?: string | null | undefined;
+            last_error?: string | null | undefined;
+        }> | undefined;
+        current_job?: string | null | undefined;
+        last_job?: string | null | undefined;
+        next_schedule?: string | null | undefined;
+        next_trigger_at?: string | null | undefined;
+        container_id?: string | null | undefined;
+        error_message?: string | null | undefined;
+    }, {
+        status?: "error" | "idle" | "running" | undefined;
+        schedules?: Record<string, {
+            status?: "idle" | "running" | "disabled" | undefined;
+            last_run_at?: string | null | undefined;
+            next_run_at?: string | null | undefined;
+            last_error?: string | null | undefined;
+        }> | undefined;
+        current_job?: string | null | undefined;
+        last_job?: string | null | undefined;
+        next_schedule?: string | null | undefined;
+        next_trigger_at?: string | null | undefined;
+        container_id?: string | null | undefined;
+        error_message?: string | null | undefined;
+    }>>>>;
+}, "strip", z.ZodTypeAny, {
+    fleet: {
+        started_at?: string | undefined;
+    };
+    agents: Record<string, {
+        status: "error" | "idle" | "running";
+        schedules?: Record<string, {
+            status: "idle" | "running" | "disabled";
+            last_run_at?: string | null | undefined;
+            next_run_at?: string | null | undefined;
+            last_error?: string | null | undefined;
+        }> | undefined;
+        current_job?: string | null | undefined;
+        last_job?: string | null | undefined;
+        next_schedule?: string | null | undefined;
+        next_trigger_at?: string | null | undefined;
+        container_id?: string | null | undefined;
+        error_message?: string | null | undefined;
+    }>;
+}, {
+    fleet?: {
+        started_at?: string | undefined;
+    } | undefined;
+    agents?: Record<string, {
+        status?: "error" | "idle" | "running" | undefined;
+        schedules?: Record<string, {
+            status?: "idle" | "running" | "disabled" | undefined;
+            last_run_at?: string | null | undefined;
+            next_run_at?: string | null | undefined;
+            last_error?: string | null | undefined;
+        }> | undefined;
+        current_job?: string | null | undefined;
+        last_job?: string | null | undefined;
+        next_schedule?: string | null | undefined;
+        next_trigger_at?: string | null | undefined;
+        container_id?: string | null | undefined;
+        error_message?: string | null | undefined;
+    }> | undefined;
+}>;
+export type ScheduleStatus = z.infer<typeof ScheduleStatusSchema>;
+export type ScheduleState = z.infer<typeof ScheduleStateSchema>;
+export type AgentStatus = z.infer<typeof AgentStatusSchema>;
+export type AgentState = z.infer<typeof AgentStateSchema>;
+export type FleetMetadata = z.infer<typeof FleetMetadataSchema>;
+export type FleetState = z.infer<typeof FleetStateSchema>;
+/**
+ * Create a new empty fleet state
+ */
+export declare function createInitialFleetState(): FleetState;
+/**
+ * Create a default schedule state
+ */
+export declare function createDefaultScheduleState(): ScheduleState;
+//# sourceMappingURL=fleet-state.d.ts.map

package/dist/state/schemas/fleet-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-state.d.ts","sourceRoot":"","sources":["../../../src/state/schemas/fleet-state.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;GAEG;AACH,eAAO,MAAM,oBAAoB,4CAA0C,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,mBAAmB;IAC9B,mDAAmD;;IAEnD,wDAAwD;;IAExD,qCAAqC;;IAErC,8DAA8D;;;;;;;;;;;;EAE9D,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,iBAAiB,yCAAuC,CAAC;AAEtE;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B,kCAAkC;;IAElC,8CAA8C;;IAE9C,mCAAmC;;IAEnC,0DAA0D;;IAE1D,8DAA8D;;IAE9D,kDAAkD;;IAElD,yCAAyC;;IAEzC,2CAA2C;;QArC3C,mDAAmD;;QAEnD,wDAAwD;;QAExD,qCAAqC;;QAErC,8DAA8D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiC9D,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,mBAAmB;IAC9B,wDAAwD;;;;;;EAExD,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B,qBAAqB;;QARrB,wDAAwD;;;;;;;IAUxD,gDAAgD;;QApChD,kCAAkC;;QAElC,8CAA8C;;QAE9C,mCAAmC;;QAEnC,0DAA0D;;QAE1D,8DAA8D;;QAE9D,kDAAkD;;QAElD,yCAAyC;;QAEzC,2CAA2C;;YArC3C,mDAAmD;;YAEnD,wDAAwD;;YAExD,qCAAqC;;YAErC,8DAA8D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuD9D,CAAC;AAMH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAM1D;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,UAAU,CAKpD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,aAAa,CAO1D"}

package/dist/state/schemas/fleet-state.js

@@ -0,0 +1,97 @@
+/**
+ * Zod schemas for fleet state (state.yaml)
+ *
+ * Defines the schema for tracking fleet-wide state including agent status
+ */
+import { z } from "zod";
+// =============================================================================
+// Schedule State Schemas
+// =============================================================================
+/**
+ * Possible states for a schedule
+ */
+export const ScheduleStatusSchema = z.enum(["idle", "running", "disabled"]);
+/**
+ * State information for a single schedule
+ */
+export const ScheduleStateSchema = z.object({
+    /** ISO timestamp of when this schedule last ran */
+    last_run_at: z.string().nullable().optional(),
+    /** ISO timestamp of when this schedule will next run */
+    next_run_at: z.string().nullable().optional(),
+    /** Current status of the schedule */
+    status: ScheduleStatusSchema.default("idle"),
+    /** Last error message if the schedule encountered an error */
+    last_error: z.string().nullable().optional(),
+});
+// =============================================================================
+// Agent Status Schemas
+// =============================================================================
+/**
+ * Possible states for an agent
+ */
+export const AgentStatusSchema = z.enum(["idle", "running", "error"]);
+/**
+ * State information for a single agent
+ */
+export const AgentStateSchema = z.object({
+    /** Current status of the agent */
+    status: AgentStatusSchema.default("idle"),
+    /** ID of the currently running job, if any */
+    current_job: z.string().nullable().optional(),
+    /** ID of the last completed job */
+    last_job: z.string().nullable().optional(),
+    /** Name of the schedule that will trigger the next run */
+    next_schedule: z.string().nullable().optional(),
+    /** ISO timestamp of when the next scheduled run will occur */
+    next_trigger_at: z.string().nullable().optional(),
+    /** Docker container ID if running in container */
+    container_id: z.string().nullable().optional(),
+    /** Error message if status is 'error' */
+    error_message: z.string().nullable().optional(),
+    /** Map of schedule names to their state */
+    schedules: z.record(z.string(), ScheduleStateSchema).optional(),
+});
+// =============================================================================
+// Fleet State Schemas
+// =============================================================================
+/**
+ * Fleet metadata stored in state.yaml
+ */
+export const FleetMetadataSchema = z.object({
+    /** ISO timestamp of when the fleet was first started */
+    started_at: z.string().optional(),
+});
+/**
+ * Top-level fleet state schema (state.yaml)
+ */
+export const FleetStateSchema = z.object({
+    /** Fleet metadata */
+    fleet: FleetMetadataSchema.optional().default({}),
+    /** Map of agent names to their current state */
+    agents: z.record(z.string(), AgentStateSchema).optional().default({}),
+});
+// =============================================================================
+// Default State
+// =============================================================================
+/**
+ * Create a new empty fleet state
+ */
+export function createInitialFleetState() {
+    return {
+        fleet: {},
+        agents: {},
+    };
+}
+/**
+ * Create a default schedule state
+ */
+export function createDefaultScheduleState() {
+    return {
+        last_run_at: null,
+        next_run_at: null,
+        status: "idle",
+        last_error: null,
+    };
+}
+//# sourceMappingURL=fleet-state.js.map

package/dist/state/schemas/fleet-state.js.map

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

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

@@ -0,0 +1,10 @@
+/**
+ * State management schemas
+ *
+ * Re-exports all Zod schemas for state management
+ */
+export { ScheduleStatusSchema, ScheduleStateSchema, AgentStatusSchema, AgentStateSchema, FleetMetadataSchema, FleetStateSchema, createInitialFleetState, createDefaultScheduleState, type ScheduleStatus, type ScheduleState, type AgentStatus, type AgentState, type FleetMetadata, type FleetState, } from "./fleet-state.js";
+export { JobStatusSchema, TriggerTypeSchema, ExitReasonSchema, JobMetadataSchema, generateJobId, createJobMetadata, type JobStatus, type TriggerType, type ExitReason, type JobMetadata, type CreateJobOptions, } from "./job-metadata.js";
+export { JobOutputTypeSchema, JobOutputBaseSchema, SystemMessageSchema, AssistantMessageSchema, ToolUseMessageSchema, ToolResultMessageSchema, ErrorMessageSchema, JobOutputMessageSchema, validateJobOutputMessage, isValidJobOutputInput, type JobOutputType, type JobOutputBase, type SystemMessage, type AssistantMessage, type ToolUseMessage, type ToolResultMessage, type ErrorMessage, type JobOutputMessage, type JobOutputInput, } from "./job-output.js";
+export { SessionModeSchema, SessionInfoSchema, createSessionInfo, type SessionMode, type SessionInfo, type CreateSessionOptions, } from "./session-info.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/state/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,EACvB,0BAA0B,EAC1B,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,gBAAgB,GACtB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EACxB,qBAAqB,EACrB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,oBAAoB,GAC1B,MAAM,mBAAmB,CAAC"}

package/dist/state/schemas/index.js

@@ -0,0 +1,10 @@
+/**
+ * State management schemas
+ *
+ * Re-exports all Zod schemas for state management
+ */
+export { ScheduleStatusSchema, ScheduleStateSchema, AgentStatusSchema, AgentStateSchema, FleetMetadataSchema, FleetStateSchema, createInitialFleetState, createDefaultScheduleState, } from "./fleet-state.js";
+export { JobStatusSchema, TriggerTypeSchema, ExitReasonSchema, JobMetadataSchema, generateJobId, createJobMetadata, } from "./job-metadata.js";
+export { JobOutputTypeSchema, JobOutputBaseSchema, SystemMessageSchema, AssistantMessageSchema, ToolUseMessageSchema, ToolResultMessageSchema, ErrorMessageSchema, JobOutputMessageSchema, validateJobOutputMessage, isValidJobOutputInput, } from "./job-output.js";
+export { SessionModeSchema, SessionInfoSchema, createSessionInfo, } from "./session-info.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/state/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,EACvB,0BAA0B,GAO3B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,iBAAiB,GAMlB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EACxB,qBAAqB,GAUtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,GAIlB,MAAM,mBAAmB,CAAC"}

package/dist/state/schemas/job-metadata.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Zod schemas for job metadata (job-<id>.yaml)
+ *
+ * Defines the schema for tracking individual job execution metadata
+ * including timing, status, and execution context.
+ */
+import { z } from "zod";
+/**
+ * Possible states for a job
+ */
+export declare const JobStatusSchema: z.ZodEnum<["pending", "running", "completed", "failed", "cancelled"]>;
+/**
+ * How the job was triggered
+ */
+export declare const TriggerTypeSchema: z.ZodEnum<["manual", "schedule", "webhook", "chat", "fork"]>;
+/**
+ * Reason why a job exited
+ */
+export declare const ExitReasonSchema: z.ZodEnum<["success", "error", "timeout", "cancelled", "max_turns"]>;
+/**
+ * Job metadata schema for individual job files
+ *
+ * Each job is stored as .herdctl/jobs/job-<id>.yaml
+ */
+export declare const JobMetadataSchema: z.ZodObject<{
+    /** Unique job identifier (format: job-YYYY-MM-DD-<random6>) */
+    id: z.ZodString;
+    /** Name of the agent that executed this job */
+    agent: z.ZodString;
+    /** Schedule name that triggered the job (if applicable) */
+    schedule: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** How the job was triggered */
+    trigger_type: z.ZodEnum<["manual", "schedule", "webhook", "chat", "fork"]>;
+    /** Current status of the job */
+    status: z.ZodEnum<["pending", "running", "completed", "failed", "cancelled"]>;
+    /** Reason the job exited (only set when status is completed/failed/cancelled) */
+    exit_reason: z.ZodOptional<z.ZodNullable<z.ZodEnum<["success", "error", "timeout", "cancelled", "max_turns"]>>>;
+    /** Session ID for the Claude agent session */
+    session_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Job ID this was forked from (if trigger_type is 'fork') */
+    forked_from: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** ISO timestamp when the job started */
+    started_at: z.ZodString;
+    /** ISO timestamp when the job finished (null if still running) */
+    finished_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Duration of the job in seconds (calculated when finished) */
+    duration_seconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    /** The prompt that was given to the agent */
+    prompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Brief summary of what the job accomplished */
+    summary: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Path to the output file containing full session output */
+    output_file: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    status: "running" | "pending" | "completed" | "failed" | "cancelled";
+    started_at: string;
+    id: string;
+    agent: string;
+    trigger_type: "webhook" | "chat" | "manual" | "schedule" | "fork";
+    prompt?: string | null | undefined;
+    schedule?: string | null | undefined;
+    exit_reason?: "max_turns" | "timeout" | "error" | "success" | "cancelled" | null | undefined;
+    session_id?: string | null | undefined;
+    forked_from?: string | null | undefined;
+    finished_at?: string | null | undefined;
+    duration_seconds?: number | null | undefined;
+    summary?: string | null | undefined;
+    output_file?: string | null | undefined;
+}, {
+    status: "running" | "pending" | "completed" | "failed" | "cancelled";
+    started_at: string;
+    id: string;
+    agent: string;
+    trigger_type: "webhook" | "chat" | "manual" | "schedule" | "fork";
+    prompt?: string | null | undefined;
+    schedule?: string | null | undefined;
+    exit_reason?: "max_turns" | "timeout" | "error" | "success" | "cancelled" | null | undefined;
+    session_id?: string | null | undefined;
+    forked_from?: string | null | undefined;
+    finished_at?: string | null | undefined;
+    duration_seconds?: number | null | undefined;
+    summary?: string | null | undefined;
+    output_file?: string | null | undefined;
+}>;
+export type JobStatus = z.infer<typeof JobStatusSchema>;
+export type TriggerType = z.infer<typeof TriggerTypeSchema>;
+export type ExitReason = z.infer<typeof ExitReasonSchema>;
+export type JobMetadata = z.infer<typeof JobMetadataSchema>;
+/**
+ * Options for creating a new job
+ */
+export interface CreateJobOptions {
+    /** Name of the agent executing the job */
+    agent: string;
+    /** How the job was triggered */
+    trigger_type: TriggerType;
+    /** Schedule name (for scheduled jobs) */
+    schedule?: string | null;
+    /** The prompt given to the agent */
+    prompt?: string | null;
+    /** Parent job ID (for forked jobs) */
+    forked_from?: string | null;
+}
+/**
+ * Generate a unique job ID with format: job-YYYY-MM-DD-<random6>
+ *
+ * @param date - Optional date to use (defaults to now)
+ * @param randomFn - Optional random function for testing
+ */
+export declare function generateJobId(date?: Date, randomFn?: () => string): string;
+/**
+ * Create initial job metadata for a new job
+ *
+ * @param options - Job creation options
+ * @param idGenerator - Optional function to generate job ID (for testing)
+ */
+export declare function createJobMetadata(options: CreateJobOptions, idGenerator?: () => string): JobMetadata;
+//# sourceMappingURL=job-metadata.d.ts.map

package/dist/state/schemas/job-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-metadata.d.ts","sourceRoot":"","sources":["../../../src/state/schemas/job-metadata.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;GAEG;AACH,eAAO,MAAM,eAAe,uEAM1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB,8DAM5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB,sEAM3B,CAAC;AAMH;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;IAC5B,+DAA+D;;IAK/D,+CAA+C;;IAG/C,2DAA2D;;IAG3D,gCAAgC;;IAGhC,gCAAgC;;IAGhC,iFAAiF;;IAGjF,8CAA8C;;IAG9C,8DAA8D;;IAO9D,yCAAyC;;IAGzC,kEAAkE;;IAGlE,gEAAgE;;IAGhE,6CAA6C;;IAG7C,iDAAiD;;IAGjD,6DAA6D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE7D,CAAC;AAMH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAM5D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,YAAY,EAAE,WAAW,CAAC;IAC1B,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,IAAI,GAAE,IAAiB,EACvB,QAAQ,GAAE,MAAM,MAAqD,GACpE,MAAM,CAOR;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,gBAAgB,EACzB,WAAW,GAAE,MAAM,MAAsB,GACxC,WAAW,CAmBb"}

package/dist/state/schemas/job-metadata.js

@@ -0,0 +1,123 @@
+/**
+ * Zod schemas for job metadata (job-<id>.yaml)
+ *
+ * Defines the schema for tracking individual job execution metadata
+ * including timing, status, and execution context.
+ */
+import { z } from "zod";
+// =============================================================================
+// Job Status Schemas
+// =============================================================================
+/**
+ * Possible states for a job
+ */
+export const JobStatusSchema = z.enum([
+    "pending",
+    "running",
+    "completed",
+    "failed",
+    "cancelled",
+]);
+/**
+ * How the job was triggered
+ */
+export const TriggerTypeSchema = z.enum([
+    "manual",
+    "schedule",
+    "webhook",
+    "chat",
+    "fork",
+]);
+/**
+ * Reason why a job exited
+ */
+export const ExitReasonSchema = z.enum([
+    "success",
+    "error",
+    "timeout",
+    "cancelled",
+    "max_turns",
+]);
+// =============================================================================
+// Job Metadata Schema
+// =============================================================================
+/**
+ * Job metadata schema for individual job files
+ *
+ * Each job is stored as .herdctl/jobs/job-<id>.yaml
+ */
+export const JobMetadataSchema = z.object({
+    /** Unique job identifier (format: job-YYYY-MM-DD-<random6>) */
+    id: z.string().regex(/^job-\d{4}-\d{2}-\d{2}-[a-z0-9]{6}$/, {
+        message: "Job ID must match format: job-YYYY-MM-DD-<random6>",
+    }),
+    /** Name of the agent that executed this job */
+    agent: z.string().min(1),
+    /** Schedule name that triggered the job (if applicable) */
+    schedule: z.string().nullable().optional(),
+    /** How the job was triggered */
+    trigger_type: TriggerTypeSchema,
+    /** Current status of the job */
+    status: JobStatusSchema,
+    /** Reason the job exited (only set when status is completed/failed/cancelled) */
+    exit_reason: ExitReasonSchema.nullable().optional(),
+    /** Session ID for the Claude agent session */
+    session_id: z.string().nullable().optional(),
+    /** Job ID this was forked from (if trigger_type is 'fork') */
+    forked_from: z
+        .string()
+        .regex(/^job-\d{4}-\d{2}-\d{2}-[a-z0-9]{6}$/)
+        .nullable()
+        .optional(),
+    /** ISO timestamp when the job started */
+    started_at: z.string(),
+    /** ISO timestamp when the job finished (null if still running) */
+    finished_at: z.string().nullable().optional(),
+    /** Duration of the job in seconds (calculated when finished) */
+    duration_seconds: z.number().nonnegative().nullable().optional(),
+    /** The prompt that was given to the agent */
+    prompt: z.string().nullable().optional(),
+    /** Brief summary of what the job accomplished */
+    summary: z.string().nullable().optional(),
+    /** Path to the output file containing full session output */
+    output_file: z.string().nullable().optional(),
+});
+/**
+ * Generate a unique job ID with format: job-YYYY-MM-DD-<random6>
+ *
+ * @param date - Optional date to use (defaults to now)
+ * @param randomFn - Optional random function for testing
+ */
+export function generateJobId(date = new Date(), randomFn = () => Math.random().toString(36).slice(2, 8)) {
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, "0");
+    const day = String(date.getDate()).padStart(2, "0");
+    const random = randomFn().slice(0, 6).padEnd(6, "0");
+    return `job-${year}-${month}-${day}-${random}`;
+}
+/**
+ * Create initial job metadata for a new job
+ *
+ * @param options - Job creation options
+ * @param idGenerator - Optional function to generate job ID (for testing)
+ */
+export function createJobMetadata(options, idGenerator = generateJobId) {
+    const now = new Date().toISOString();
+    return {
+        id: idGenerator(),
+        agent: options.agent,
+        schedule: options.schedule ?? null,
+        trigger_type: options.trigger_type,
+        status: "pending",
+        exit_reason: null,
+        session_id: null,
+        forked_from: options.forked_from ?? null,
+        started_at: now,
+        finished_at: null,
+        duration_seconds: null,
+        prompt: options.prompt ?? null,
+        summary: null,
+        output_file: null,
+    };
+}
+//# sourceMappingURL=job-metadata.js.map

package/dist/state/schemas/job-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-metadata.js","sourceRoot":"","sources":["../../../src/state/schemas/job-metadata.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC;IACpC,SAAS;IACT,SAAS;IACT,WAAW;IACX,QAAQ;IACR,WAAW;CACZ,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC;IACtC,QAAQ;IACR,UAAU;IACV,SAAS;IACT,MAAM;IACN,MAAM;CACP,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC;IACrC,SAAS;IACT,OAAO;IACP,SAAS;IACT,WAAW;IACX,WAAW;CACZ,CAAC,CAAC;AAEH,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,+DAA+D;IAC/D,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,qCAAqC,EAAE;QAC1D,OAAO,EAAE,oDAAoD;KAC9D,CAAC;IAEF,+CAA+C;IAC/C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAExB,2DAA2D;IAC3D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAE1C,gCAAgC;IAChC,YAAY,EAAE,iBAAiB;IAE/B,gCAAgC;IAChC,MAAM,EAAE,eAAe;IAEvB,iFAAiF;IACjF,WAAW,EAAE,gBAAgB,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAEnD,8CAA8C;IAC9C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAE5C,8DAA8D;IAC9D,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,KAAK,CAAC,qCAAqC,CAAC;SAC5C,QAAQ,EAAE;SACV,QAAQ,EAAE;IAEb,yCAAyC;IACzC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IAEtB,kEAAkE;IAClE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAE7C,gEAAgE;IAChE,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAEhE,6CAA6C;IAC7C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAExC,iDAAiD;IACjD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAEzC,6DAA6D;IAC7D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC9C,CAAC,CAAC;AA+BH;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAa,IAAI,IAAI,EAAE,EACvB,WAAyB,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;IAErE,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAErD,OAAO,OAAO,IAAI,IAAI,KAAK,IAAI,GAAG,IAAI,MAAM,EAAE,CAAC;AACjD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAyB,EACzB,cAA4B,aAAa;IAEzC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAErC,OAAO;QACL,EAAE,EAAE,WAAW,EAAE;QACjB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI;QAClC,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,MAAM,EAAE,SAAS;QACjB,WAAW,EAAE,IAAI;QACjB,UAAU,EAAE,IAAI;QAChB,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI;QACxC,UAAU,EAAE,GAAG;QACf,WAAW,EAAE,IAAI;QACjB,gBAAgB,EAAE,IAAI;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;QAC9B,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,IAAI;KAClB,CAAC;AACJ,CAAC"}