@herdctl/core 0.0.1

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

@@ -0,0 +1,291 @@
+/**
+ * Zod schemas for job output messages (job-<id>.jsonl)
+ *
+ * Defines the schema for streaming job output from Claude SDK.
+ * Each line in the JSONL file is a JobOutputMessage.
+ */
+import { z } from "zod";
+/**
+ * Types of messages from Claude SDK streaming output
+ */
+export declare const JobOutputTypeSchema: z.ZodEnum<["system", "assistant", "tool_use", "tool_result", "error"]>;
+/**
+ * Base fields present in all job output messages
+ */
+export declare const JobOutputBaseSchema: z.ZodObject<{
+    /** Message type */
+    type: z.ZodEnum<["system", "assistant", "tool_use", "tool_result", "error"]>;
+    /** ISO timestamp when message was recorded */
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "error" | "system" | "assistant" | "tool_use" | "tool_result";
+    timestamp: string;
+}, {
+    type: "error" | "system" | "assistant" | "tool_use" | "tool_result";
+    timestamp: string;
+}>;
+/**
+ * System message schema
+ */
+export declare const SystemMessageSchema: z.ZodObject<{
+    timestamp: z.ZodString;
+} & {
+    type: z.ZodLiteral<"system">;
+    content: z.ZodOptional<z.ZodString>;
+    subtype: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "system";
+    timestamp: string;
+    content?: string | undefined;
+    subtype?: string | undefined;
+}, {
+    type: "system";
+    timestamp: string;
+    content?: string | undefined;
+    subtype?: string | undefined;
+}>;
+/**
+ * Assistant message schema
+ */
+export declare const AssistantMessageSchema: z.ZodObject<{
+    timestamp: z.ZodString;
+} & {
+    type: z.ZodLiteral<"assistant">;
+    content: z.ZodOptional<z.ZodString>;
+    partial: z.ZodOptional<z.ZodBoolean>;
+    usage: z.ZodOptional<z.ZodObject<{
+        input_tokens: z.ZodOptional<z.ZodNumber>;
+        output_tokens: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        input_tokens?: number | undefined;
+        output_tokens?: number | undefined;
+    }, {
+        input_tokens?: number | undefined;
+        output_tokens?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    type: "assistant";
+    timestamp: string;
+    partial?: boolean | undefined;
+    content?: string | undefined;
+    usage?: {
+        input_tokens?: number | undefined;
+        output_tokens?: number | undefined;
+    } | undefined;
+}, {
+    type: "assistant";
+    timestamp: string;
+    partial?: boolean | undefined;
+    content?: string | undefined;
+    usage?: {
+        input_tokens?: number | undefined;
+        output_tokens?: number | undefined;
+    } | undefined;
+}>;
+/**
+ * Tool use message schema
+ */
+export declare const ToolUseMessageSchema: z.ZodObject<{
+    timestamp: z.ZodString;
+} & {
+    type: z.ZodLiteral<"tool_use">;
+    tool_name: z.ZodString;
+    tool_use_id: z.ZodOptional<z.ZodString>;
+    input: z.ZodOptional<z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    type: "tool_use";
+    timestamp: string;
+    tool_name: string;
+    tool_use_id?: string | undefined;
+    input?: unknown;
+}, {
+    type: "tool_use";
+    timestamp: string;
+    tool_name: string;
+    tool_use_id?: string | undefined;
+    input?: unknown;
+}>;
+/**
+ * Tool result message schema
+ */
+export declare const ToolResultMessageSchema: z.ZodObject<{
+    timestamp: z.ZodString;
+} & {
+    type: z.ZodLiteral<"tool_result">;
+    tool_use_id: z.ZodOptional<z.ZodString>;
+    result: z.ZodOptional<z.ZodUnknown>;
+    success: z.ZodOptional<z.ZodBoolean>;
+    error: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "tool_result";
+    timestamp: string;
+    error?: string | undefined;
+    success?: boolean | undefined;
+    tool_use_id?: string | undefined;
+    result?: unknown;
+}, {
+    type: "tool_result";
+    timestamp: string;
+    error?: string | undefined;
+    success?: boolean | undefined;
+    tool_use_id?: string | undefined;
+    result?: unknown;
+}>;
+/**
+ * Error message schema
+ */
+export declare const ErrorMessageSchema: z.ZodObject<{
+    timestamp: z.ZodString;
+} & {
+    type: z.ZodLiteral<"error">;
+    message: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+    stack: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    type: "error";
+    timestamp: string;
+    code?: string | undefined;
+    stack?: string | undefined;
+}, {
+    message: string;
+    type: "error";
+    timestamp: string;
+    code?: string | undefined;
+    stack?: string | undefined;
+}>;
+/**
+ * Schema that validates any job output message type
+ */
+export declare const JobOutputMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    timestamp: z.ZodString;
+} & {
+    type: z.ZodLiteral<"system">;
+    content: z.ZodOptional<z.ZodString>;
+    subtype: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "system";
+    timestamp: string;
+    content?: string | undefined;
+    subtype?: string | undefined;
+}, {
+    type: "system";
+    timestamp: string;
+    content?: string | undefined;
+    subtype?: string | undefined;
+}>, z.ZodObject<{
+    timestamp: z.ZodString;
+} & {
+    type: z.ZodLiteral<"assistant">;
+    content: z.ZodOptional<z.ZodString>;
+    partial: z.ZodOptional<z.ZodBoolean>;
+    usage: z.ZodOptional<z.ZodObject<{
+        input_tokens: z.ZodOptional<z.ZodNumber>;
+        output_tokens: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        input_tokens?: number | undefined;
+        output_tokens?: number | undefined;
+    }, {
+        input_tokens?: number | undefined;
+        output_tokens?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    type: "assistant";
+    timestamp: string;
+    partial?: boolean | undefined;
+    content?: string | undefined;
+    usage?: {
+        input_tokens?: number | undefined;
+        output_tokens?: number | undefined;
+    } | undefined;
+}, {
+    type: "assistant";
+    timestamp: string;
+    partial?: boolean | undefined;
+    content?: string | undefined;
+    usage?: {
+        input_tokens?: number | undefined;
+        output_tokens?: number | undefined;
+    } | undefined;
+}>, z.ZodObject<{
+    timestamp: z.ZodString;
+} & {
+    type: z.ZodLiteral<"tool_use">;
+    tool_name: z.ZodString;
+    tool_use_id: z.ZodOptional<z.ZodString>;
+    input: z.ZodOptional<z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    type: "tool_use";
+    timestamp: string;
+    tool_name: string;
+    tool_use_id?: string | undefined;
+    input?: unknown;
+}, {
+    type: "tool_use";
+    timestamp: string;
+    tool_name: string;
+    tool_use_id?: string | undefined;
+    input?: unknown;
+}>, z.ZodObject<{
+    timestamp: z.ZodString;
+} & {
+    type: z.ZodLiteral<"tool_result">;
+    tool_use_id: z.ZodOptional<z.ZodString>;
+    result: z.ZodOptional<z.ZodUnknown>;
+    success: z.ZodOptional<z.ZodBoolean>;
+    error: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "tool_result";
+    timestamp: string;
+    error?: string | undefined;
+    success?: boolean | undefined;
+    tool_use_id?: string | undefined;
+    result?: unknown;
+}, {
+    type: "tool_result";
+    timestamp: string;
+    error?: string | undefined;
+    success?: boolean | undefined;
+    tool_use_id?: string | undefined;
+    result?: unknown;
+}>, z.ZodObject<{
+    timestamp: z.ZodString;
+} & {
+    type: z.ZodLiteral<"error">;
+    message: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+    stack: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    type: "error";
+    timestamp: string;
+    code?: string | undefined;
+    stack?: string | undefined;
+}, {
+    message: string;
+    type: "error";
+    timestamp: string;
+    code?: string | undefined;
+    stack?: string | undefined;
+}>]>;
+export type JobOutputType = z.infer<typeof JobOutputTypeSchema>;
+export type JobOutputBase = z.infer<typeof JobOutputBaseSchema>;
+export type SystemMessage = z.infer<typeof SystemMessageSchema>;
+export type AssistantMessage = z.infer<typeof AssistantMessageSchema>;
+export type ToolUseMessage = z.infer<typeof ToolUseMessageSchema>;
+export type ToolResultMessage = z.infer<typeof ToolResultMessageSchema>;
+export type ErrorMessage = z.infer<typeof ErrorMessageSchema>;
+export type JobOutputMessage = z.infer<typeof JobOutputMessageSchema>;
+/**
+ * Input type for appending messages (timestamp added automatically)
+ */
+export type JobOutputInput = Omit<SystemMessage, "timestamp"> | Omit<AssistantMessage, "timestamp"> | Omit<ToolUseMessage, "timestamp"> | Omit<ToolResultMessage, "timestamp"> | Omit<ErrorMessage, "timestamp">;
+/**
+ * Validate a job output message
+ */
+export declare function validateJobOutputMessage(message: unknown): JobOutputMessage | null;
+/**
+ * Check if a message has the minimum required fields
+ */
+export declare function isValidJobOutputInput(input: unknown): input is JobOutputInput;
+//# sourceMappingURL=job-output.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"job-output.d.ts","sourceRoot":"","sources":["../../../src/state/schemas/job-output.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;GAEG;AACH,eAAO,MAAM,mBAAmB,wEAM9B,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,mBAAmB;IAC9B,mBAAmB;;IAEnB,8CAA8C;;;;;;;;EAE9C,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;EAM9B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAajC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;EAQ/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;EAUlC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;EAQ7B,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAMjC,CAAC;AAMH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAMtE;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,GAChC,IAAI,CAAC,gBAAgB,EAAE,WAAW,CAAC,GACnC,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,GACjC,IAAI,CAAC,iBAAiB,EAAE,WAAW,CAAC,GACpC,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;AAEpC;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,OAAO,GACf,gBAAgB,GAAG,IAAI,CAGzB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAS7E"}

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

@@ -0,0 +1,132 @@
+/**
+ * Zod schemas for job output messages (job-<id>.jsonl)
+ *
+ * Defines the schema for streaming job output from Claude SDK.
+ * Each line in the JSONL file is a JobOutputMessage.
+ */
+import { z } from "zod";
+// =============================================================================
+// Message Type Schema
+// =============================================================================
+/**
+ * Types of messages from Claude SDK streaming output
+ */
+export const JobOutputTypeSchema = z.enum([
+    "system",
+    "assistant",
+    "tool_use",
+    "tool_result",
+    "error",
+]);
+// =============================================================================
+// Base Message Schema
+// =============================================================================
+/**
+ * Base fields present in all job output messages
+ */
+export const JobOutputBaseSchema = z.object({
+    /** Message type */
+    type: JobOutputTypeSchema,
+    /** ISO timestamp when message was recorded */
+    timestamp: z.string(),
+});
+// =============================================================================
+// Specific Message Type Schemas
+// =============================================================================
+/**
+ * System message schema
+ */
+export const SystemMessageSchema = JobOutputBaseSchema.extend({
+    type: z.literal("system"),
+    /** System message content */
+    content: z.string().optional(),
+    /** Optional subtype for system messages */
+    subtype: z.string().optional(),
+});
+/**
+ * Assistant message schema
+ */
+export const AssistantMessageSchema = JobOutputBaseSchema.extend({
+    type: z.literal("assistant"),
+    /** Assistant response content */
+    content: z.string().optional(),
+    /** Whether this is a partial/streaming chunk */
+    partial: z.boolean().optional(),
+    /** Token usage info if available */
+    usage: z
+        .object({
+        input_tokens: z.number().optional(),
+        output_tokens: z.number().optional(),
+    })
+        .optional(),
+});
+/**
+ * Tool use message schema
+ */
+export const ToolUseMessageSchema = JobOutputBaseSchema.extend({
+    type: z.literal("tool_use"),
+    /** Tool being invoked */
+    tool_name: z.string(),
+    /** Unique identifier for this tool call */
+    tool_use_id: z.string().optional(),
+    /** Tool input parameters */
+    input: z.unknown().optional(),
+});
+/**
+ * Tool result message schema
+ */
+export const ToolResultMessageSchema = JobOutputBaseSchema.extend({
+    type: z.literal("tool_result"),
+    /** ID of the tool call this is a result for */
+    tool_use_id: z.string().optional(),
+    /** Tool execution result */
+    result: z.unknown().optional(),
+    /** Whether the tool execution succeeded */
+    success: z.boolean().optional(),
+    /** Error message if tool failed */
+    error: z.string().optional(),
+});
+/**
+ * Error message schema
+ */
+export const ErrorMessageSchema = JobOutputBaseSchema.extend({
+    type: z.literal("error"),
+    /** Error message */
+    message: z.string(),
+    /** Error code if available */
+    code: z.string().optional(),
+    /** Stack trace if available */
+    stack: z.string().optional(),
+});
+// =============================================================================
+// Union Schema for All Message Types
+// =============================================================================
+/**
+ * Schema that validates any job output message type
+ */
+export const JobOutputMessageSchema = z.discriminatedUnion("type", [
+    SystemMessageSchema,
+    AssistantMessageSchema,
+    ToolUseMessageSchema,
+    ToolResultMessageSchema,
+    ErrorMessageSchema,
+]);
+/**
+ * Validate a job output message
+ */
+export function validateJobOutputMessage(message) {
+    const result = JobOutputMessageSchema.safeParse(message);
+    return result.success ? result.data : null;
+}
+/**
+ * Check if a message has the minimum required fields
+ */
+export function isValidJobOutputInput(input) {
+    if (typeof input !== "object" || input === null) {
+        return false;
+    }
+    const obj = input;
+    return (typeof obj.type === "string" &&
+        JobOutputTypeSchema.safeParse(obj.type).success);
+}
+//# sourceMappingURL=job-output.js.map

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

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

package/dist/state/schemas/session-info.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Zod schemas for session info (sessions/<agent-name>.json)
+ *
+ * Defines the schema for tracking Claude session information per agent,
+ * enabling session resume and fork capabilities.
+ */
+import { z } from "zod";
+/**
+ * The operational mode of the session
+ */
+export declare const SessionModeSchema: z.ZodEnum<["autonomous", "interactive", "review"]>;
+/**
+ * Session info schema for individual agent session files
+ *
+ * Each session is stored as .herdctl/sessions/<agent-name>.json
+ */
+export declare const SessionInfoSchema: z.ZodObject<{
+    /** Name of the agent this session belongs to */
+    agent_name: z.ZodString;
+    /** Claude session ID for resuming conversations */
+    session_id: z.ZodString;
+    /** ISO timestamp when the session was created */
+    created_at: z.ZodString;
+    /** ISO timestamp when the session was last used */
+    last_used_at: z.ZodString;
+    /** Number of jobs executed in this session */
+    job_count: z.ZodNumber;
+    /** Current operational mode of the session */
+    mode: z.ZodEnum<["autonomous", "interactive", "review"]>;
+}, "strip", z.ZodTypeAny, {
+    mode: "autonomous" | "interactive" | "review";
+    session_id: string;
+    agent_name: string;
+    created_at: string;
+    last_used_at: string;
+    job_count: number;
+}, {
+    mode: "autonomous" | "interactive" | "review";
+    session_id: string;
+    agent_name: string;
+    created_at: string;
+    last_used_at: string;
+    job_count: number;
+}>;
+export type SessionMode = z.infer<typeof SessionModeSchema>;
+export type SessionInfo = z.infer<typeof SessionInfoSchema>;
+/**
+ * Options for creating a new session
+ */
+export interface CreateSessionOptions {
+    /** Name of the agent */
+    agent_name: string;
+    /** Claude session ID */
+    session_id: string;
+    /** Operational mode (defaults to 'autonomous') */
+    mode?: SessionMode;
+}
+/**
+ * Create initial session info for a new session
+ *
+ * @param options - Session creation options
+ * @returns A validated SessionInfo object
+ */
+export declare function createSessionInfo(options: CreateSessionOptions): SessionInfo;
+//# sourceMappingURL=session-info.d.ts.map

package/dist/state/schemas/session-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-info.d.ts","sourceRoot":"","sources":["../../../src/state/schemas/session-info.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;GAEG;AACH,eAAO,MAAM,iBAAiB,oDAI5B,CAAC;AAMH;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;IAC5B,gDAAgD;;IAGhD,mDAAmD;;IAGnD,iDAAiD;;IAGjD,mDAAmD;;IAGnD,8CAA8C;;IAG9C,8CAA8C;;;;;;;;;;;;;;;;EAE9C,CAAC;AAMH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAM5D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,GAAG,WAAW,CAW5E"}

package/dist/state/schemas/session-info.js

@@ -0,0 +1,58 @@
+/**
+ * Zod schemas for session info (sessions/<agent-name>.json)
+ *
+ * Defines the schema for tracking Claude session information per agent,
+ * enabling session resume and fork capabilities.
+ */
+import { z } from "zod";
+// =============================================================================
+// Session Mode Schema
+// =============================================================================
+/**
+ * The operational mode of the session
+ */
+export const SessionModeSchema = z.enum([
+    "autonomous",
+    "interactive",
+    "review",
+]);
+// =============================================================================
+// Session Info Schema
+// =============================================================================
+/**
+ * Session info schema for individual agent session files
+ *
+ * Each session is stored as .herdctl/sessions/<agent-name>.json
+ */
+export const SessionInfoSchema = z.object({
+    /** Name of the agent this session belongs to */
+    agent_name: z.string().min(1, "Agent name cannot be empty"),
+    /** Claude session ID for resuming conversations */
+    session_id: z.string().min(1, "Session ID cannot be empty"),
+    /** ISO timestamp when the session was created */
+    created_at: z.string().datetime({ message: "created_at must be a valid ISO datetime string" }),
+    /** ISO timestamp when the session was last used */
+    last_used_at: z.string().datetime({ message: "last_used_at must be a valid ISO datetime string" }),
+    /** Number of jobs executed in this session */
+    job_count: z.number().int().nonnegative(),
+    /** Current operational mode of the session */
+    mode: SessionModeSchema,
+});
+/**
+ * Create initial session info for a new session
+ *
+ * @param options - Session creation options
+ * @returns A validated SessionInfo object
+ */
+export function createSessionInfo(options) {
+    const now = new Date().toISOString();
+    return {
+        agent_name: options.agent_name,
+        session_id: options.session_id,
+        created_at: now,
+        last_used_at: now,
+        job_count: 0,
+        mode: options.mode ?? "autonomous",
+    };
+}
+//# sourceMappingURL=session-info.js.map

package/dist/state/schemas/session-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-info.js","sourceRoot":"","sources":["../../../src/state/schemas/session-info.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC;IACtC,YAAY;IACZ,aAAa;IACb,QAAQ;CACT,CAAC,CAAC;AAEH,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,gDAAgD;IAChD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,4BAA4B,CAAC;IAE3D,mDAAmD;IACnD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,4BAA4B,CAAC;IAE3D,iDAAiD;IACjD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,gDAAgD,EAAE,CAAC;IAE9F,mDAAmD;IACnD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,kDAAkD,EAAE,CAAC;IAElG,8CAA8C;IAC9C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAEzC,8CAA8C;IAC9C,IAAI,EAAE,iBAAiB;CACxB,CAAC,CAAC;AAyBH;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA6B;IAC7D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAErC,OAAO;QACL,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,UAAU,EAAE,GAAG;QACf,YAAY,EAAE,GAAG;QACjB,SAAS,EAAE,CAAC;QACZ,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,YAAY;KACnC,CAAC;AACJ,CAAC"}

package/dist/state/session.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Session state persistence operations
+ *
+ * Provides CRUD operations for session info files stored at
+ * .herdctl/sessions/<agent-name>.json
+ */
+import { type SessionInfo } from "./schemas/session-info.js";
+/**
+ * Options for session operations
+ */
+export interface SessionOptions {
+    /** Logger for warnings */
+    logger?: SessionLogger;
+}
+/**
+ * Logger interface for session operations
+ */
+export interface SessionLogger {
+    warn: (message: string) => void;
+}
+/**
+ * Partial updates for session info
+ */
+export type SessionInfoUpdates = Partial<Omit<SessionInfo, "agent_name" | "created_at">>;
+/**
+ * Get session info for an agent
+ *
+ * Returns null if no session exists (handles missing file gracefully).
+ *
+ * @param sessionsDir - Path to the sessions directory
+ * @param agentName - Name of the agent
+ * @param options - Optional operation options
+ * @returns The session info, or null if not found
+ *
+ * @example
+ * ```typescript
+ * const session = await getSessionInfo('/path/to/.herdctl/sessions', 'my-agent');
+ * if (session) {
+ *   console.log(`Session ${session.session_id} has ${session.job_count} jobs`);
+ * } else {
+ *   console.log('No existing session');
+ * }
+ * ```
+ */
+export declare function getSessionInfo(sessionsDir: string, agentName: string, options?: SessionOptions): Promise<SessionInfo | null>;
+/**
+ * Update session info for an agent
+ *
+ * If no session exists, creates a new one with the provided updates.
+ * Automatically updates last_used_at timestamp.
+ *
+ * @param sessionsDir - Path to the sessions directory
+ * @param agentName - Name of the agent
+ * @param updates - Updates to apply to the session
+ * @returns The updated session info
+ * @throws StateFileError if the file cannot be written
+ *
+ * @example
+ * ```typescript
+ * // Update existing session
+ * const session = await updateSessionInfo('/path/to/.herdctl/sessions', 'my-agent', {
+ *   job_count: 5,
+ *   mode: 'interactive',
+ * });
+ *
+ * // Create new session
+ * const newSession = await updateSessionInfo('/path/to/.herdctl/sessions', 'new-agent', {
+ *   session_id: 'claude-session-abc123',
+ *   mode: 'autonomous',
+ * });
+ * ```
+ */
+export declare function updateSessionInfo(sessionsDir: string, agentName: string, updates: SessionInfoUpdates): Promise<SessionInfo>;
+/**
+ * Clear session info for an agent (delete the session file)
+ *
+ * @param sessionsDir - Path to the sessions directory
+ * @param agentName - Name of the agent
+ * @returns true if the session was deleted, false if it didn't exist
+ *
+ * @example
+ * ```typescript
+ * const cleared = await clearSession('/path/to/.herdctl/sessions', 'my-agent');
+ * if (cleared) {
+ *   console.log('Session cleared');
+ * } else {
+ *   console.log('No session to clear');
+ * }
+ * ```
+ */
+export declare function clearSession(sessionsDir: string, agentName: string): Promise<boolean>;
+//# sourceMappingURL=session.d.ts.map

package/dist/state/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/state/session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAGL,KAAK,WAAW,EAGjB,MAAM,2BAA2B,CAAC;AAOnC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,CACtC,IAAI,CAAC,WAAW,EAAE,YAAY,GAAG,YAAY,CAAC,CAC/C,CAAC;AAiBF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CA6B7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,WAAW,CAAC,CAkEtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAiBlB"}