@herdctl/core 1.3.1 → 2.0.0

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

@@ -1 +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;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,EAAE,CAAC,CAuCxB"}
+{"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;IACvB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,OAAO,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;CACzB;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;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CA8D7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,WAAW,CAAC,CAmEtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAiBlB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,EAAE,CAAC,CAuCxB"}

package/dist/state/session.js

@@ -25,25 +25,33 @@ function getSessionFilePath(sessionsDir, agentName) {
 /**
  * Get session info for an agent
  *
- * Returns null if no session exists (handles missing file gracefully).
+ * Returns null if no session exists, is corrupted, or has expired.
+ * When a timeout is provided, expired sessions are automatically cleared
+ * to prevent stale session IDs from being used for resume attempts.
  *
  * @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
+ * @param options - Optional operation options including timeout for expiry validation
+ * @returns The session info, or null if not found/expired
  *
  * @example
  * ```typescript
+ * // Get session without expiry validation
  * 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');
  * }
+ *
+ * // Get session with 24-hour expiry validation (prevents unexpected logouts)
+ * const session = await getSessionInfo('/path/to/.herdctl/sessions', 'my-agent', {
+ *   timeout: '24h'  // Sessions older than 24 hours will be treated as expired
+ * });
  * ```
  */
 export async function getSessionInfo(sessionsDir, agentName, options = {}) {
-    const { logger = console } = options;
+    const { logger = console, timeout } = options;
     const filePath = getSessionFilePath(sessionsDir, agentName);
     const result = await safeReadJson(filePath);
     if (!result.success) {
@@ -55,13 +63,39 @@ export async function getSessionInfo(sessionsDir, agentName, options = {}) {
         logger.warn(`Failed to read session file for ${agentName}: ${result.error.message}`);
         return null;
     }
-    // Parse and validate
+    // Parse and validate schema
     const parseResult = SessionInfoSchema.safeParse(result.data);
     if (!parseResult.success) {
         logger.warn(`Corrupted session file for ${agentName}: ${parseResult.error.message}. Returning null.`);
         return null;
     }
-    return parseResult.data;
+    const session = parseResult.data;
+    // If timeout is provided, validate session expiry and optionally file existence
+    // Dynamic import to avoid circular dependency with session-validation.ts
+    if (timeout) {
+        const { validateSession, validateSessionWithFileCheck } = await import("./session-validation.js");
+        // For CLI runtime, check both expiration and file existence
+        // For SDK runtime (or unspecified), only check expiration
+        const validation = options.runtime === "cli"
+            ? await validateSessionWithFileCheck(session, timeout)
+            : validateSession(session, timeout);
+        if (!validation.valid) {
+            if (validation.reason === "expired" || validation.reason === "file_not_found") {
+                logger.warn(`Session for ${agentName} is invalid: ${validation.message}. Clearing stale session.`);
+                // Clear the invalid session to prevent stale session IDs from being used
+                await clearSession(sessionsDir, agentName).catch(() => {
+                    // Ignore errors during cleanup - session is already treated as invalid
+                });
+            }
+            else if (validation.reason === "invalid_timeout") {
+                logger.warn(`Invalid timeout format for session validation: ${validation.message}`);
+                // Still return session if timeout format is invalid - don't fail the operation
+                return session;
+            }
+            return null;
+        }
+    }
+    return session;
 }
 /**
  * Update session info for an agent
@@ -120,6 +154,7 @@ export async function updateSessionInfo(sessionsDir, agentName, updates) {
             agent_name: agentName,
             session_id: updates.session_id,
             mode: updates.mode,
+            working_directory: updates.working_directory,
         });
         updatedSession = {
             ...newSession,

package/dist/state/session.js.map

@@ -1 +1 @@
-{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/state/session.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/state/session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EACL,iBAAiB,EACjB,iBAAiB,GAIlB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAwC7C,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF;;GAEG;AACH,SAAS,kBAAkB,CAAC,WAAmB,EAAE,SAAiB;IAChE,OAAO,IAAI,CAAC,WAAW,EAAE,GAAG,SAAS,OAAO,CAAC,CAAC;AAChD,CAAC;AAED,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,WAAmB,EACnB,SAAiB,EACjB,UAA0B,EAAE;IAE5B,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAC9C,MAAM,QAAQ,GAAG,kBAAkB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAE5D,MAAM,MAAM,GAAG,MAAM,YAAY,CAAU,QAAQ,CAAC,CAAC;IAErD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,+CAA+C;QAC/C,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,sDAAsD;QACtD,MAAM,CAAC,IAAI,CACT,mCAAmC,SAAS,KAAK,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CACxE,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4BAA4B;IAC5B,MAAM,WAAW,GAAG,iBAAiB,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7D,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CACT,8BAA8B,SAAS,KAAK,WAAW,CAAC,KAAK,CAAC,OAAO,mBAAmB,CACzF,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC;IAEjC,gFAAgF;IAChF,yEAAyE;IACzE,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,EAAE,eAAe,EAAE,4BAA4B,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;QAElG,4DAA4D;QAC5D,0DAA0D;QAC1D,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,KAAK,KAAK;YAC1C,CAAC,CAAC,MAAM,4BAA4B,CAAC,OAAO,EAAE,OAAO,CAAC;YACtD,CAAC,CAAC,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAEtC,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;YACtB,IAAI,UAAU,CAAC,MAAM,KAAK,SAAS,IAAI,UAAU,CAAC,MAAM,KAAK,gBAAgB,EAAE,CAAC;gBAC9E,MAAM,CAAC,IAAI,CACT,eAAe,SAAS,gBAAgB,UAAU,CAAC,OAAO,2BAA2B,CACtF,CAAC;gBACF,yEAAyE;gBACzE,MAAM,YAAY,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;oBACpD,uEAAuE;gBACzE,CAAC,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,UAAU,CAAC,MAAM,KAAK,iBAAiB,EAAE,CAAC;gBACnD,MAAM,CAAC,IAAI,CACT,kDAAkD,UAAU,CAAC,OAAO,EAAE,CACvE,CAAC;gBACF,+EAA+E;gBAC/E,OAAO,OAAO,CAAC;YACjB,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,WAAmB,EACnB,SAAiB,EACjB,OAA2B;IAE3B,MAAM,QAAQ,GAAG,kBAAkB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAE5D,+BAA+B;IAC/B,MAAM,cAAc,GAAG,MAAM,YAAY,CAAU,QAAQ,CAAC,CAAC;IAC7D,IAAI,eAAe,GAAuB,IAAI,CAAC;IAE/C,IAAI,cAAc,CAAC,OAAO,EAAE,CAAC;QAC3B,MAAM,WAAW,GAAG,iBAAiB,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QACrE,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;YACxB,eAAe,GAAG,WAAW,CAAC,IAAI,CAAC;QACrC,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAErC,IAAI,cAA2B,CAAC;IAEhC,IAAI,eAAe,EAAE,CAAC;QACpB,0BAA0B;QAC1B,cAAc,GAAG;YACf,GAAG,eAAe;YAClB,GAAG,OAAO;YACV,YAAY,EAAE,GAAG,EAAE,6BAA6B;SACjD,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,+DAA+D;QAC/D,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YACxB,MAAM,IAAI,cAAc,CACtB,oDAAoD,EACpD,QAAQ,EACR,OAAO,CACR,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,iBAAiB,CAAC;YACnC,UAAU,EAAE,SAAS;YACrB,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;SAC7C,CAAC,CAAC;QAEH,cAAc,GAAG;YACf,GAAG,UAAU;YACb,GAAG,OAAO;YACV,UAAU,EAAE,SAAS,EAAE,uCAAuC;YAC9D,UAAU,EAAE,UAAU,CAAC,UAAU,EAAE,sBAAsB;YACzD,YAAY,EAAE,GAAG;SAClB,CAAC;IACJ,CAAC;IAED,+BAA+B;IAC/B,MAAM,SAAS,GAAG,iBAAiB,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAE1D,mBAAmB;IACnB,IAAI,CAAC;QACH,MAAM,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,cAAc,CACtB,qCAAqC,SAAS,KAAM,KAAe,CAAC,OAAO,EAAE,EAC7E,QAAQ,EACR,OAAO,EACP,KAAc,CACf,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,WAAmB,EACnB,SAAiB;IAEjB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAE5D,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,IAAI,cAAc,CACtB,qCAAqC,SAAS,KAAM,KAAe,CAAC,OAAO,EAAE,EAC7E,QAAQ,EACR,OAAO,EACP,KAAc,CACf,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,WAAmB,EACnB,UAA0B,EAAE;IAE5B,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,GAAG,OAAO,CAAC;IAErC,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,gEAAgE;QAChE,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,sCAAuC,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9E,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,QAAQ,GAAkB,EAAE,CAAC;IAEnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,2BAA2B;QAC3B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,SAAS;QACX,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,WAAW,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAEtE,IAAI,OAAO,EAAE,CAAC;YACZ,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,sDAAsD;IACtD,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACrB,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC;QACjD,OAAO,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/state/working-directory-validation.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Working directory validation utilities
+ *
+ * Provides validation to detect when a session's working directory has changed,
+ * which would cause Claude Code to look for the session file in the wrong
+ * project directory and fail to resume.
+ */
+import type { SessionInfo } from "./schemas/session-info.js";
+/**
+ * Result of working directory validation
+ */
+export interface WorkingDirectoryValidation {
+    /** Whether the working directory is valid (unchanged) */
+    valid: boolean;
+    /** If invalid, the reason why */
+    reason?: "changed" | "missing";
+    /** Human-readable message */
+    message?: string;
+    /** Old working directory path from session */
+    oldPath?: string;
+    /** New working directory path from current config */
+    newPath?: string;
+}
+/**
+ * Validate that a session's working directory matches the current working directory
+ *
+ * Claude Code stores session files in project directories based on the cwd.
+ * If the working directory changes between sessions, Claude Code will look for
+ * the session file in a different directory and fail with ENOENT.
+ *
+ * This function compares the stored working_directory from the session with the
+ * current working_directory to detect this condition so we can clear the stale
+ * session and start fresh.
+ *
+ * @param session - The session info to validate (null if no session exists)
+ * @param currentWorkingDirectory - The current working directory from agent config
+ * @returns Validation result with change details
+ *
+ * @example
+ * ```typescript
+ * const session = await getSessionInfo(sessionsDir, agentName);
+ * const currentWd = resolveWorkingDirectory(agent);
+ * const validation = validateWorkingDirectory(session, currentWd);
+ *
+ * if (!validation.valid) {
+ *   logger.warn(`Working directory changed: ${validation.message}`);
+ *   await clearSession(sessionsDir, agentName);
+ * }
+ * ```
+ */
+export declare function validateWorkingDirectory(session: SessionInfo | null, currentWorkingDirectory: string | undefined): WorkingDirectoryValidation;
+//# sourceMappingURL=working-directory-validation.d.ts.map

package/dist/state/working-directory-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"working-directory-validation.d.ts","sourceRoot":"","sources":["../../src/state/working-directory-validation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAM7D;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,yDAAyD;IACzD,KAAK,EAAE,OAAO,CAAC;IACf,iCAAiC;IACjC,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,6BAA6B;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,WAAW,GAAG,IAAI,EAC3B,uBAAuB,EAAE,MAAM,GAAG,SAAS,GAC1C,0BAA0B,CAgD5B"}

package/dist/state/working-directory-validation.js

@@ -0,0 +1,81 @@
+/**
+ * Working directory validation utilities
+ *
+ * Provides validation to detect when a session's working directory has changed,
+ * which would cause Claude Code to look for the session file in the wrong
+ * project directory and fail to resume.
+ */
+// =============================================================================
+// Validation
+// =============================================================================
+/**
+ * Validate that a session's working directory matches the current working directory
+ *
+ * Claude Code stores session files in project directories based on the cwd.
+ * If the working directory changes between sessions, Claude Code will look for
+ * the session file in a different directory and fail with ENOENT.
+ *
+ * This function compares the stored working_directory from the session with the
+ * current working_directory to detect this condition so we can clear the stale
+ * session and start fresh.
+ *
+ * @param session - The session info to validate (null if no session exists)
+ * @param currentWorkingDirectory - The current working directory from agent config
+ * @returns Validation result with change details
+ *
+ * @example
+ * ```typescript
+ * const session = await getSessionInfo(sessionsDir, agentName);
+ * const currentWd = resolveWorkingDirectory(agent);
+ * const validation = validateWorkingDirectory(session, currentWd);
+ *
+ * if (!validation.valid) {
+ *   logger.warn(`Working directory changed: ${validation.message}`);
+ *   await clearSession(sessionsDir, agentName);
+ * }
+ * ```
+ */
+export function validateWorkingDirectory(session, currentWorkingDirectory) {
+    // No session to validate
+    if (!session) {
+        return { valid: true };
+    }
+    const oldPath = session.working_directory;
+    const newPath = currentWorkingDirectory;
+    // Both undefined - OK (backward compat: old sessions without working_directory)
+    if (!oldPath && !newPath) {
+        return { valid: true };
+    }
+    // One is undefined, other is defined - Changed
+    if (!oldPath && newPath) {
+        return {
+            valid: false,
+            reason: "changed",
+            message: `Working directory changed from undefined to ${newPath}`,
+            oldPath: undefined,
+            newPath,
+        };
+    }
+    if (oldPath && !newPath) {
+        return {
+            valid: false,
+            reason: "changed",
+            message: `Working directory changed from ${oldPath} to undefined`,
+            oldPath,
+            newPath: undefined,
+        };
+    }
+    // Both defined but different - Changed
+    if (oldPath !== newPath) {
+        return {
+            valid: false,
+            reason: "changed",
+            message: `Working directory changed from ${oldPath} to ${newPath}`,
+            oldPath,
+            newPath,
+        };
+    }
+    // Same working directory - Valid
+    return { valid: true };
+}
+//# sourceMappingURL=working-directory-validation.js.map

package/dist/state/working-directory-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"working-directory-validation.js","sourceRoot":"","sources":["../../src/state/working-directory-validation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwBH,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAA2B,EAC3B,uBAA2C;IAE3C,yBAAyB;IACzB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAC1C,MAAM,OAAO,GAAG,uBAAuB,CAAC;IAExC,gFAAgF;IAChF,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,+CAA+C;IAC/C,IAAI,CAAC,OAAO,IAAI,OAAO,EAAE,CAAC;QACxB,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,+CAA+C,OAAO,EAAE;YACjE,OAAO,EAAE,SAAS;YAClB,OAAO;SACR,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;QACxB,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,kCAAkC,OAAO,eAAe;YACjE,OAAO;YACP,OAAO,EAAE,SAAS;SACnB,CAAC;IACJ,CAAC;IAED,uCAAuC;IACvC,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACxB,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,kCAAkC,OAAO,OAAO,OAAO,EAAE;YAClE,OAAO;YACP,OAAO;SACR,CAAC;IACJ,CAAC;IAED,iCAAiC;IACjC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@herdctl/core",
-  "version": "1.3.1",
+  "version": "2.0.0",
   "description": "Core library for herdctl fleet management",
   "license": "MIT",
   "type": "module",
@@ -11,13 +11,16 @@
   ],
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.1.0",
+    "chokidar": "^5",
     "cron-parser": "^4.9.0",
+    "dockerode": "^4.0.9",
     "dotenv": "^17.2.3",
+    "execa": "^9",
     "yaml": "^2.3.0",
     "zod": "^3.22.0"
   },
   "peerDependencies": {
-    "@herdctl/discord": "0.1.4"
+    "@herdctl/discord": "0.1.5"
   },
   "peerDependenciesMeta": {
     "@herdctl/discord": {
@@ -25,6 +28,7 @@
     }
   },
   "devDependencies": {
+    "@types/dockerode": "^4.0.1",
     "@vitest/coverage-v8": "^4.0.17",
     "typescript": "^5",
     "vitest": "^4.0.17"
@@ -50,6 +54,7 @@
   },
   "scripts": {
     "build": "tsc",
+    "postbuild": "node --input-type=module -e \"import('./dist/index.js').then(() => console.log('✓ Core module loads successfully'))\"",
     "dev": "tsc --watch",
     "typecheck": "tsc --noEmit",
     "test": "vitest run --coverage"