@herdctl/core 5.5.0 → 5.6.0

package/dist/distribution/fleet-config-updater.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Fleet Config Updater for Agent Distribution
+ *
+ * Programmatically updates herdctl.yaml to add or remove agent references.
+ * Preserves comments and formatting by using yaml's parseDocument approach.
+ */
+import { FleetManagerError, type FleetManagerErrorCode } from "../fleet-manager/errors.js";
+/**
+ * Options for fleet config operations
+ */
+export interface FleetConfigUpdateOptions {
+    /** Path to the herdctl.yaml file */
+    configPath: string;
+    /** Relative path to the agent's yaml file (e.g., "./agents/my-agent/agent.yaml") */
+    agentPath: string;
+}
+/**
+ * Result of a fleet config update operation
+ */
+export interface FleetConfigUpdateResult {
+    /** Whether the config was actually modified */
+    modified: boolean;
+    /** The agent path that was added or removed */
+    agentPath: string;
+    /** Whether this agent was already referenced (for add) or not found (for remove) */
+    alreadyExists: boolean;
+}
+/** Error code: herdctl.yaml doesn't exist */
+export declare const CONFIG_NOT_FOUND: FleetManagerErrorCode;
+/** Error code: herdctl.yaml is invalid YAML */
+export declare const CONFIG_PARSE_ERROR: FleetManagerErrorCode;
+/** Error code: couldn't write the updated config */
+export declare const CONFIG_WRITE_ERROR: FleetManagerErrorCode;
+/**
+ * Error thrown when fleet config operations fail
+ */
+export declare class FleetConfigError extends FleetManagerError {
+    constructor(message: string, code: FleetManagerErrorCode);
+}
+/**
+ * Add an agent reference to the fleet config's agents array
+ *
+ * This function:
+ * 1. Reads the herdctl.yaml file, preserving comments and formatting
+ * 2. Checks if the agent path already exists in the agents array
+ * 3. If not, appends a new entry to the agents array
+ * 4. Writes the updated config back to disk
+ *
+ * @param options - Update options including config path and agent path
+ * @returns Result indicating if the config was modified
+ * @throws {FleetConfigError} When the operation fails
+ *
+ * @example
+ * ```typescript
+ * const result = await addAgentToFleetConfig({
+ *   configPath: "/path/to/herdctl.yaml",
+ *   agentPath: "./agents/my-agent/agent.yaml"
+ * });
+ *
+ * if (result.modified) {
+ *   console.log(`Added agent reference: ${result.agentPath}`);
+ * } else if (result.alreadyExists) {
+ *   console.log(`Agent already referenced: ${result.agentPath}`);
+ * }
+ * ```
+ */
+export declare function addAgentToFleetConfig(options: FleetConfigUpdateOptions): Promise<FleetConfigUpdateResult>;
+/**
+ * Remove an agent reference from the fleet config's agents array
+ *
+ * This function:
+ * 1. Reads the herdctl.yaml file, preserving comments and formatting
+ * 2. Finds the agent path in the agents array
+ * 3. If found, removes the entry from the agents array
+ * 4. Writes the updated config back to disk
+ *
+ * @param options - Update options including config path and agent path
+ * @returns Result indicating if the config was modified
+ * @throws {FleetConfigError} When the operation fails
+ *
+ * @example
+ * ```typescript
+ * const result = await removeAgentFromFleetConfig({
+ *   configPath: "/path/to/herdctl.yaml",
+ *   agentPath: "./agents/my-agent/agent.yaml"
+ * });
+ *
+ * if (result.modified) {
+ *   console.log(`Removed agent reference: ${result.agentPath}`);
+ * } else if (!result.alreadyExists) {
+ *   console.log(`Agent was not referenced: ${result.agentPath}`);
+ * }
+ * ```
+ */
+export declare function removeAgentFromFleetConfig(options: FleetConfigUpdateOptions): Promise<FleetConfigUpdateResult>;
+//# sourceMappingURL=fleet-config-updater.d.ts.map

package/dist/distribution/fleet-config-updater.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-config-updater.d.ts","sourceRoot":"","sources":["../../src/distribution/fleet-config-updater.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAE,iBAAiB,EAAE,KAAK,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAS3F;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,+CAA+C;IAC/C,QAAQ,EAAE,OAAO,CAAC;IAClB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,oFAAoF;IACpF,aAAa,EAAE,OAAO,CAAC;CACxB;AAMD,6CAA6C;AAC7C,eAAO,MAAM,gBAAgB,EAAE,qBAA0C,CAAC;AAE1E,+CAA+C;AAC/C,eAAO,MAAM,kBAAkB,EAAE,qBAA4C,CAAC;AAE9E,oDAAoD;AACpD,eAAO,MAAM,kBAAkB,EAAE,qBAA4C,CAAC;AAE9E;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,iBAAiB;gBACzC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB;CAIzD;AAyID;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,uBAAuB,CAAC,CA6ClC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,uBAAuB,CAAC,CA+ClC"}

package/dist/distribution/fleet-config-updater.js

@@ -0,0 +1,266 @@
+/**
+ * Fleet Config Updater for Agent Distribution
+ *
+ * Programmatically updates herdctl.yaml to add or remove agent references.
+ * Preserves comments and formatting by using yaml's parseDocument approach.
+ */
+import * as fs from "node:fs/promises";
+import { isMap, isSeq, parseDocument, YAMLParseError } from "yaml";
+import { FleetManagerError } from "../fleet-manager/errors.js";
+import { createLogger } from "../utils/logger.js";
+const logger = createLogger("distribution:fleet-config");
+// =============================================================================
+// Error Classes
+// =============================================================================
+/** Error code: herdctl.yaml doesn't exist */
+export const CONFIG_NOT_FOUND = "CONFIG_NOT_FOUND";
+/** Error code: herdctl.yaml is invalid YAML */
+export const CONFIG_PARSE_ERROR = "CONFIG_PARSE_ERROR";
+/** Error code: couldn't write the updated config */
+export const CONFIG_WRITE_ERROR = "CONFIG_WRITE_ERROR";
+/**
+ * Error thrown when fleet config operations fail
+ */
+export class FleetConfigError extends FleetManagerError {
+    constructor(message, code) {
+        super(message, { code });
+        this.name = "FleetConfigError";
+    }
+}
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Check if a file exists
+ */
+async function fileExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Read and parse the fleet config file, preserving document structure
+ */
+async function readFleetConfig(configPath) {
+    // Check if file exists
+    if (!(await fileExists(configPath))) {
+        throw new FleetConfigError(`Fleet config not found at ${configPath}. Run 'herdctl init fleet' to create one.`, CONFIG_NOT_FOUND);
+    }
+    // Read file content
+    let content;
+    try {
+        content = await fs.readFile(configPath, "utf-8");
+    }
+    catch (err) {
+        const error = err;
+        throw new FleetConfigError(`Failed to read fleet config: ${error.message}`, CONFIG_NOT_FOUND);
+    }
+    // Parse YAML preserving document structure
+    try {
+        const doc = parseDocument(content);
+        // parseDocument may not throw but can store errors in doc.errors
+        if (doc.errors && doc.errors.length > 0) {
+            const firstError = doc.errors[0];
+            const position = firstError.linePos?.[0];
+            const locationInfo = position ? ` at line ${position.line}, column ${position.col}` : "";
+            throw new FleetConfigError(`Invalid YAML syntax in fleet config${locationInfo}: ${firstError.message}`, CONFIG_PARSE_ERROR);
+        }
+        return doc;
+    }
+    catch (err) {
+        // Re-throw FleetConfigError as-is
+        if (err instanceof FleetConfigError) {
+            throw err;
+        }
+        if (err instanceof YAMLParseError) {
+            const position = err.linePos?.[0];
+            const locationInfo = position ? ` at line ${position.line}, column ${position.col}` : "";
+            throw new FleetConfigError(`Invalid YAML syntax in fleet config${locationInfo}: ${err.message}`, CONFIG_PARSE_ERROR);
+        }
+        throw new FleetConfigError(`Failed to parse fleet config: ${err.message}`, CONFIG_PARSE_ERROR);
+    }
+}
+/**
+ * Write the fleet config back to disk
+ */
+async function writeFleetConfig(configPath, doc) {
+    try {
+        await fs.writeFile(configPath, doc.toString(), "utf-8");
+    }
+    catch (err) {
+        const error = err;
+        throw new FleetConfigError(`Failed to write fleet config: ${error.message}`, CONFIG_WRITE_ERROR);
+    }
+}
+/**
+ * Check if an agent path already exists in the agents array
+ */
+function findAgentInArray(agentsNode, agentPath) {
+    if (!isSeq(agentsNode)) {
+        return -1;
+    }
+    for (let i = 0; i < agentsNode.items.length; i++) {
+        const item = agentsNode.items[i];
+        // Handle both object form { path: "..." } and string form "..."
+        if (isMap(item)) {
+            const pathNode = item.get("path");
+            if (typeof pathNode === "string" && pathNode === agentPath) {
+                return i;
+            }
+        }
+        else if (typeof item === "string" && item === agentPath) {
+            return i;
+        }
+        // Also check the JSON value if it's a scalar node
+        const itemValue = item && typeof item === "object" && "toJSON" in item
+            ? item.toJSON()
+            : item;
+        if (typeof itemValue === "object" && itemValue !== null && "path" in itemValue) {
+            if (itemValue.path === agentPath) {
+                return i;
+            }
+        }
+        if (typeof itemValue === "string" && itemValue === agentPath) {
+            return i;
+        }
+    }
+    return -1;
+}
+// =============================================================================
+// Main Functions
+// =============================================================================
+/**
+ * Add an agent reference to the fleet config's agents array
+ *
+ * This function:
+ * 1. Reads the herdctl.yaml file, preserving comments and formatting
+ * 2. Checks if the agent path already exists in the agents array
+ * 3. If not, appends a new entry to the agents array
+ * 4. Writes the updated config back to disk
+ *
+ * @param options - Update options including config path and agent path
+ * @returns Result indicating if the config was modified
+ * @throws {FleetConfigError} When the operation fails
+ *
+ * @example
+ * ```typescript
+ * const result = await addAgentToFleetConfig({
+ *   configPath: "/path/to/herdctl.yaml",
+ *   agentPath: "./agents/my-agent/agent.yaml"
+ * });
+ *
+ * if (result.modified) {
+ *   console.log(`Added agent reference: ${result.agentPath}`);
+ * } else if (result.alreadyExists) {
+ *   console.log(`Agent already referenced: ${result.agentPath}`);
+ * }
+ * ```
+ */
+export async function addAgentToFleetConfig(options) {
+    const { configPath, agentPath } = options;
+    logger.debug("Adding agent to fleet config", { configPath, agentPath });
+    // Read and parse the config
+    const doc = await readFleetConfig(configPath);
+    // Get the agents node
+    const agentsNode = doc.get("agents", true);
+    // Check for duplicate
+    if (findAgentInArray(agentsNode, agentPath) !== -1) {
+        logger.debug("Agent already exists in fleet config", { agentPath });
+        return {
+            modified: false,
+            agentPath,
+            alreadyExists: true,
+        };
+    }
+    // Create the new agent reference node
+    const agentRef = doc.createNode({ path: agentPath });
+    // Add to agents array
+    if (isSeq(agentsNode)) {
+        // Already a sequence ([] or block) - append to it
+        agentsNode.items.push(agentRef);
+        logger.debug("Appended agent to existing agents array", { agentPath });
+    }
+    else {
+        // No agents key or it's not a sequence - set it
+        doc.set("agents", doc.createNode([{ path: agentPath }]));
+        logger.debug("Created agents array with agent", { agentPath });
+    }
+    // Write the updated config
+    await writeFleetConfig(configPath, doc);
+    logger.info("Added agent to fleet config", { configPath, agentPath });
+    return {
+        modified: true,
+        agentPath,
+        alreadyExists: false,
+    };
+}
+/**
+ * Remove an agent reference from the fleet config's agents array
+ *
+ * This function:
+ * 1. Reads the herdctl.yaml file, preserving comments and formatting
+ * 2. Finds the agent path in the agents array
+ * 3. If found, removes the entry from the agents array
+ * 4. Writes the updated config back to disk
+ *
+ * @param options - Update options including config path and agent path
+ * @returns Result indicating if the config was modified
+ * @throws {FleetConfigError} When the operation fails
+ *
+ * @example
+ * ```typescript
+ * const result = await removeAgentFromFleetConfig({
+ *   configPath: "/path/to/herdctl.yaml",
+ *   agentPath: "./agents/my-agent/agent.yaml"
+ * });
+ *
+ * if (result.modified) {
+ *   console.log(`Removed agent reference: ${result.agentPath}`);
+ * } else if (!result.alreadyExists) {
+ *   console.log(`Agent was not referenced: ${result.agentPath}`);
+ * }
+ * ```
+ */
+export async function removeAgentFromFleetConfig(options) {
+    const { configPath, agentPath } = options;
+    logger.debug("Removing agent from fleet config", { configPath, agentPath });
+    // Read and parse the config
+    const doc = await readFleetConfig(configPath);
+    // Get the agents node
+    const agentsNode = doc.get("agents", true);
+    // Check if agents array exists and is a sequence
+    if (!isSeq(agentsNode)) {
+        logger.debug("No agents array in fleet config", { agentPath });
+        return {
+            modified: false,
+            agentPath,
+            alreadyExists: false,
+        };
+    }
+    // Find the agent in the array
+    const index = findAgentInArray(agentsNode, agentPath);
+    if (index === -1) {
+        logger.debug("Agent not found in fleet config", { agentPath });
+        return {
+            modified: false,
+            agentPath,
+            alreadyExists: false,
+        };
+    }
+    // Remove the agent from the array
+    agentsNode.items.splice(index, 1);
+    logger.debug("Removed agent from agents array", { agentPath, index });
+    // Write the updated config
+    await writeFleetConfig(configPath, doc);
+    logger.info("Removed agent from fleet config", { configPath, agentPath });
+    return {
+        modified: true,
+        agentPath,
+        alreadyExists: true,
+    };
+}
+//# sourceMappingURL=fleet-config-updater.js.map

package/dist/distribution/fleet-config-updater.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-config-updater.js","sourceRoot":"","sources":["../../src/distribution/fleet-config-updater.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAEnE,OAAO,EAAE,iBAAiB,EAA8B,MAAM,4BAA4B,CAAC;AAC3F,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,MAAM,GAAG,YAAY,CAAC,2BAA2B,CAAC,CAAC;AA4BzD,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF,6CAA6C;AAC7C,MAAM,CAAC,MAAM,gBAAgB,GAA0B,kBAAkB,CAAC;AAE1E,+CAA+C;AAC/C,MAAM,CAAC,MAAM,kBAAkB,GAA0B,oBAAoB,CAAC;AAE9E,oDAAoD;AACpD,MAAM,CAAC,MAAM,kBAAkB,GAA0B,oBAAoB,CAAC;AAE9E;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,iBAAiB;IACrD,YAAY,OAAe,EAAE,IAA2B;QACtD,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF;;GAEG;AACH,KAAK,UAAU,UAAU,CAAC,QAAgB;IACxC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,eAAe,CAAC,UAAkB;IAC/C,uBAAuB;IACvB,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,gBAAgB,CACxB,6BAA6B,UAAU,2CAA2C,EAClF,gBAAgB,CACjB,CAAC;IACJ,CAAC;IAED,oBAAoB;IACpB,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,GAAY,CAAC;QAC3B,MAAM,IAAI,gBAAgB,CAAC,gCAAgC,KAAK,CAAC,OAAO,EAAE,EAAE,gBAAgB,CAAC,CAAC;IAChG,CAAC;IAED,2CAA2C;IAC3C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QAEnC,iEAAiE;QACjE,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACjC,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;YACzC,MAAM,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,YAAY,QAAQ,CAAC,IAAI,YAAY,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzF,MAAM,IAAI,gBAAgB,CACxB,sCAAsC,YAAY,KAAK,UAAU,CAAC,OAAO,EAAE,EAC3E,kBAAkB,CACnB,CAAC;QACJ,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,kCAAkC;QAClC,IAAI,GAAG,YAAY,gBAAgB,EAAE,CAAC;YACpC,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,IAAI,GAAG,YAAY,cAAc,EAAE,CAAC;YAClC,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;YAClC,MAAM,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,YAAY,QAAQ,CAAC,IAAI,YAAY,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzF,MAAM,IAAI,gBAAgB,CACxB,sCAAsC,YAAY,KAAK,GAAG,CAAC,OAAO,EAAE,EACpE,kBAAkB,CACnB,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,gBAAgB,CACxB,iCAAkC,GAAa,CAAC,OAAO,EAAE,EACzD,kBAAkB,CACnB,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,gBAAgB,CAC7B,UAAkB,EAClB,GAAqC;IAErC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,GAAY,CAAC;QAC3B,MAAM,IAAI,gBAAgB,CACxB,iCAAiC,KAAK,CAAC,OAAO,EAAE,EAChD,kBAAkB,CACnB,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CACvB,UAAwD,EACxD,SAAiB;IAEjB,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,CAAC,CAAC;IACZ,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACjD,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACjC,gEAAgE;QAChE,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAChB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAClC,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3D,OAAO,CAAC,CAAC;YACX,CAAC;QACH,CAAC;aAAM,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YAC1D,OAAO,CAAC,CAAC;QACX,CAAC;QACD,kDAAkD;QAClD,MAAM,SAAS,GACb,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,QAAQ,IAAI,IAAI;YAClD,CAAC,CAAE,IAAkC,CAAC,MAAM,EAAE;YAC9C,CAAC,CAAC,IAAI,CAAC;QACX,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI,IAAI,MAAM,IAAI,SAAS,EAAE,CAAC;YAC/E,IAAK,SAA8B,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvD,OAAO,CAAC,CAAC;YACX,CAAC;QACH,CAAC;QACD,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC7D,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAED,OAAO,CAAC,CAAC,CAAC;AACZ,CAAC;AAED,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAiC;IAEjC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAE1C,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;IAExE,4BAA4B;IAC5B,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC;IAE9C,sBAAsB;IACtB,MAAM,UAAU,GAAG,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAE3C,sBAAsB;IACtB,IAAI,gBAAgB,CAAC,UAAU,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QACnD,MAAM,CAAC,KAAK,CAAC,sCAAsC,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QACpE,OAAO;YACL,QAAQ,EAAE,KAAK;YACf,SAAS;YACT,aAAa,EAAE,IAAI;SACpB,CAAC;IACJ,CAAC;IAED,sCAAsC;IACtC,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IAErD,sBAAsB;IACtB,IAAI,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QACtB,kDAAkD;QAClD,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChC,MAAM,CAAC,KAAK,CAAC,yCAAyC,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IACzE,CAAC;SAAM,CAAC;QACN,gDAAgD;QAChD,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;QACzD,MAAM,CAAC,KAAK,CAAC,iCAAiC,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,2BAA2B;IAC3B,MAAM,gBAAgB,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAExC,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;IAEtE,OAAO;QACL,QAAQ,EAAE,IAAI;QACd,SAAS;QACT,aAAa,EAAE,KAAK;KACrB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,OAAiC;IAEjC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAE1C,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;IAE5E,4BAA4B;IAC5B,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC;IAE9C,sBAAsB;IACtB,MAAM,UAAU,GAAG,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAE3C,iDAAiD;IACjD,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QACvB,MAAM,CAAC,KAAK,CAAC,iCAAiC,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QAC/D,OAAO;YACL,QAAQ,EAAE,KAAK;YACf,SAAS;YACT,aAAa,EAAE,KAAK;SACrB,CAAC;IACJ,CAAC;IAED,8BAA8B;IAC9B,MAAM,KAAK,GAAG,gBAAgB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAEtD,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QACjB,MAAM,CAAC,KAAK,CAAC,iCAAiC,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QAC/D,OAAO;YACL,QAAQ,EAAE,KAAK;YACf,SAAS;YACT,aAAa,EAAE,KAAK;SACrB,CAAC;IACJ,CAAC;IAED,kCAAkC;IAClC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAClC,MAAM,CAAC,KAAK,CAAC,iCAAiC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IAEtE,2BAA2B;IAC3B,MAAM,gBAAgB,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAExC,MAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;IAE1E,OAAO;QACL,QAAQ,EAAE,IAAI;QACd,SAAS;QACT,aAAa,EAAE,IAAI;KACpB,CAAC;AACJ,CAAC"}

package/dist/distribution/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Distribution module for herdctl
+ *
+ * Provides schemas and utilities for the agent distribution system:
+ * - Agent repository metadata validation (herdctl.json)
+ * - Installation metadata tracking (metadata.json)
+ * - Source specifier parsing and repository fetching
+ * - Agent discovery and listing
+ * - Agent detailed information
+ * - Agent removal
+ */
+export { AgentDiscoveryError, DISCOVERY_CONFIG_INVALID, DISCOVERY_CONFIG_NOT_FOUND, type DiscoveredAgent, type DiscoveryOptions, type DiscoveryResult, discoverAgents, } from "./agent-discovery.js";
+export { type AgentDetailedInfo, type AgentInfoOptions, getAgentInfo, } from "./agent-info.js";
+export { AGENT_NOT_FOUND, AgentRemoveError, type RemoveOptions, type RemoveResult, removeAgent, } from "./agent-remover.js";
+export { AGENT_NAME_PATTERN, type AgentRepoMetadata, AgentRepoMetadataSchema, type AgentRequires, AgentRequiresSchema, } from "./agent-repo-metadata.js";
+export { type EnvScanResult, type EnvVariable, scanEnvVariables, } from "./env-scanner.js";
+export { AGENT_ALREADY_EXISTS, AgentInstallError, INVALID_AGENT_NAME, INVALID_AGENT_YAML as INSTALLER_INVALID_AGENT_YAML, type InstallOptions, type InstallResult, installAgentFiles, MISSING_AGENT_YAML as INSTALLER_MISSING_AGENT_YAML, } from "./file-installer.js";
+export { addAgentToFleetConfig, CONFIG_NOT_FOUND, CONFIG_PARSE_ERROR, CONFIG_WRITE_ERROR, FleetConfigError, type FleetConfigUpdateOptions, type FleetConfigUpdateResult, removeAgentFromFleetConfig, } from "./fleet-config-updater.js";
+export { type InstallationMetadata, InstallationMetadataSchema, type InstallationSource, InstallationSourceSchema, ISO8601TimestampSchema, type SourceType, SourceTypeSchema, } from "./installation-metadata.js";
+export { type FetchSource, fetchRepository, GitHubCloneAuthError, type GitHubFetchSource, GitHubRepoNotFoundError, type LocalFetchSource, LocalPathError, NetworkError, RepositoryFetchError, type RepositoryFetchResult, } from "./repository-fetcher.js";
+export { DOCKER_NETWORK_NONE, INVALID_AGENT_YAML, INVALID_HERDCTL_JSON, JSON_PARSE_ERROR, MISSING_AGENT_YAML, MISSING_CLAUDE_MD, MISSING_HERDCTL_JSON, MISSING_README, NAME_MISMATCH, type ValidationMessage, type ValidationResult, validateRepository, YAML_PARSE_ERROR, } from "./repository-validator.js";
+export { type GitHubSource, isGitHubSource, isLocalSource, type LocalSource, parseSourceSpecifier, SourceParseError, type SourceSpecifier, stringifySourceSpecifier, } from "./source-specifier.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/distribution/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/distribution/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,0BAA0B,EAC1B,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,YAAY,GACb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,kBAAkB,EAClB,KAAK,iBAAiB,EACtB,uBAAuB,EACvB,KAAK,aAAa,EAClB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAEL,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,IAAI,4BAA4B,EAClD,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,iBAAiB,EACjB,kBAAkB,IAAI,4BAA4B,GACnD,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,0BAA0B,GAC3B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,KAAK,oBAAoB,EACzB,0BAA0B,EAC1B,KAAK,kBAAkB,EACvB,wBAAwB,EACxB,sBAAsB,EACtB,KAAK,UAAU,EACf,gBAAgB,GACjB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,KAAK,WAAW,EAChB,eAAe,EAEf,oBAAoB,EACpB,KAAK,iBAAiB,EACtB,uBAAuB,EACvB,KAAK,gBAAgB,EACrB,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,KAAK,qBAAqB,GAC3B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAEhB,kBAAkB,EAClB,iBAAiB,EAEjB,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,KAAK,YAAY,EACjB,cAAc,EACd,aAAa,EACb,KAAK,WAAW,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,eAAe,EACpB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC"}

package/dist/distribution/index.js

@@ -0,0 +1,42 @@
+/**
+ * Distribution module for herdctl
+ *
+ * Provides schemas and utilities for the agent distribution system:
+ * - Agent repository metadata validation (herdctl.json)
+ * - Installation metadata tracking (metadata.json)
+ * - Source specifier parsing and repository fetching
+ * - Agent discovery and listing
+ * - Agent detailed information
+ * - Agent removal
+ */
+// Agent Discovery
+export { AgentDiscoveryError, DISCOVERY_CONFIG_INVALID, DISCOVERY_CONFIG_NOT_FOUND, discoverAgents, } from "./agent-discovery.js";
+// Agent Info
+export { getAgentInfo, } from "./agent-info.js";
+// Agent Remover
+export { AGENT_NOT_FOUND, AgentRemoveError, removeAgent, } from "./agent-remover.js";
+// Agent Repository Metadata (herdctl.json)
+export { AGENT_NAME_PATTERN, AgentRepoMetadataSchema, AgentRequiresSchema, } from "./agent-repo-metadata.js";
+// Environment Variable Scanner
+export { scanEnvVariables, } from "./env-scanner.js";
+// File Installation
+export { 
+// Error codes
+AGENT_ALREADY_EXISTS, AgentInstallError, INVALID_AGENT_NAME, INVALID_AGENT_YAML as INSTALLER_INVALID_AGENT_YAML, installAgentFiles, MISSING_AGENT_YAML as INSTALLER_MISSING_AGENT_YAML, } from "./file-installer.js";
+// Fleet Config Updater
+export { addAgentToFleetConfig, CONFIG_NOT_FOUND, CONFIG_PARSE_ERROR, CONFIG_WRITE_ERROR, FleetConfigError, removeAgentFromFleetConfig, } from "./fleet-config-updater.js";
+// Installation Metadata (metadata.json)
+export { InstallationMetadataSchema, InstallationSourceSchema, ISO8601TimestampSchema, SourceTypeSchema, } from "./installation-metadata.js";
+// Repository Fetching
+export { fetchRepository, 
+// Error classes
+GitHubCloneAuthError, GitHubRepoNotFoundError, LocalPathError, NetworkError, RepositoryFetchError, } from "./repository-fetcher.js";
+// Repository Validation
+export { DOCKER_NETWORK_NONE, INVALID_AGENT_YAML, INVALID_HERDCTL_JSON, JSON_PARSE_ERROR, 
+// Error codes
+MISSING_AGENT_YAML, MISSING_CLAUDE_MD, 
+// Warning codes
+MISSING_HERDCTL_JSON, MISSING_README, NAME_MISMATCH, validateRepository, YAML_PARSE_ERROR, } from "./repository-validator.js";
+// Source Specifier Parsing
+export { isGitHubSource, isLocalSource, parseSourceSpecifier, SourceParseError, stringifySourceSpecifier, } from "./source-specifier.js";
+//# sourceMappingURL=index.js.map

package/dist/distribution/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/distribution/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,kBAAkB;AAClB,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,0BAA0B,EAI1B,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,aAAa;AACb,OAAO,EAGL,YAAY,GACb,MAAM,iBAAiB,CAAC;AACzB,gBAAgB;AAChB,OAAO,EACL,eAAe,EACf,gBAAgB,EAGhB,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAC5B,2CAA2C;AAC3C,OAAO,EACL,kBAAkB,EAElB,uBAAuB,EAEvB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAClC,+BAA+B;AAC/B,OAAO,EAGL,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,oBAAoB;AACpB,OAAO;AACL,cAAc;AACd,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,IAAI,4BAA4B,EAGlD,iBAAiB,EACjB,kBAAkB,IAAI,4BAA4B,GACnD,MAAM,qBAAqB,CAAC;AAC7B,uBAAuB;AACvB,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAGhB,0BAA0B,GAC3B,MAAM,2BAA2B,CAAC;AACnC,wCAAwC;AACxC,OAAO,EAEL,0BAA0B,EAE1B,wBAAwB,EACxB,sBAAsB,EAEtB,gBAAgB,GACjB,MAAM,4BAA4B,CAAC;AACpC,sBAAsB;AACtB,OAAO,EAEL,eAAe;AACf,gBAAgB;AAChB,oBAAoB,EAEpB,uBAAuB,EAEvB,cAAc,EACd,YAAY,EACZ,oBAAoB,GAErB,MAAM,yBAAyB,CAAC;AACjC,wBAAwB;AACxB,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB;AAChB,cAAc;AACd,kBAAkB,EAClB,iBAAiB;AACjB,gBAAgB;AAChB,oBAAoB,EACpB,cAAc,EACd,aAAa,EAGb,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AACnC,2BAA2B;AAC3B,OAAO,EAEL,cAAc,EACd,aAAa,EAEb,oBAAoB,EACpB,gBAAgB,EAEhB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC"}

package/dist/distribution/installation-metadata.d.ts

@@ -0,0 +1,191 @@
+/**
+ * Installation metadata schema for agent distribution
+ *
+ * Validates the `metadata.json` file that lives in each installed agent's
+ * directory root. This file tracks where an agent was installed from and when.
+ *
+ * The schema is intentionally extensible (no .strict()) to support future
+ * features like agentic initialization without breaking existing installs.
+ */
+import { z } from "zod";
+/**
+ * Source types for installed agents
+ *
+ * - `github`: Installed from a GitHub repository
+ * - `local`: Installed from a local filesystem path
+ */
+export declare const SourceTypeSchema: z.ZodEnum<["github", "local"]>;
+/** Union type of valid source types */
+export type SourceType = z.infer<typeof SourceTypeSchema>;
+/**
+ * Source information schema
+ *
+ * Tracks the origin of an installed agent. The `type` field is required,
+ * while other fields are optional and depend on the source type:
+ *
+ * - `url`: The original source URL or path (GitHub URL, local path)
+ * - `ref`: Git reference (tag, branch, commit SHA) for GitHub sources
+ * - `version`: Version from herdctl.json at install time
+ */
+export declare const InstallationSourceSchema: z.ZodObject<{
+    /** The type of source (github or local) */
+    type: z.ZodEnum<["github", "local"]>;
+    /** The original source URL or path */
+    url: z.ZodOptional<z.ZodString>;
+    /** Git reference (tag, branch, commit) for version-controlled sources */
+    ref: z.ZodOptional<z.ZodString>;
+    /** Version from herdctl.json at install time */
+    version: z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    /** The type of source (github or local) */
+    type: z.ZodEnum<["github", "local"]>;
+    /** The original source URL or path */
+    url: z.ZodOptional<z.ZodString>;
+    /** Git reference (tag, branch, commit) for version-controlled sources */
+    ref: z.ZodOptional<z.ZodString>;
+    /** Version from herdctl.json at install time */
+    version: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    /** The type of source (github or local) */
+    type: z.ZodEnum<["github", "local"]>;
+    /** The original source URL or path */
+    url: z.ZodOptional<z.ZodString>;
+    /** Git reference (tag, branch, commit) for version-controlled sources */
+    ref: z.ZodOptional<z.ZodString>;
+    /** Version from herdctl.json at install time */
+    version: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;
+/** Type for installation source information */
+export type InstallationSource = z.infer<typeof InstallationSourceSchema>;
+/**
+ * Schema for ISO 8601 formatted timestamps
+ */
+export declare const ISO8601TimestampSchema: z.ZodString;
+/**
+ * Installation metadata schema
+ *
+ * This schema validates the `metadata.json` file that tracks installation
+ * information for each agent. It is intentionally extensible (uses default
+ * Zod behavior, not .strict()) to allow adding future fields like
+ * `initialization` without breaking existing installs.
+ *
+ * @example
+ * ```json
+ * {
+ *   "source": {
+ *     "type": "github",
+ *     "url": "https://github.com/user/agent-repo",
+ *     "ref": "v1.0.0",
+ *     "version": "1.0.0"
+ *   },
+ *   "installed_at": "2024-01-15T10:30:00Z",
+ *   "installed_by": "herdctl@0.5.0"
+ * }
+ * ```
+ */
+export declare const InstallationMetadataSchema: z.ZodObject<{
+    /** Source information - where the agent was installed from */
+    source: z.ZodObject<{
+        /** The type of source (github or local) */
+        type: z.ZodEnum<["github", "local"]>;
+        /** The original source URL or path */
+        url: z.ZodOptional<z.ZodString>;
+        /** Git reference (tag, branch, commit) for version-controlled sources */
+        ref: z.ZodOptional<z.ZodString>;
+        /** Version from herdctl.json at install time */
+        version: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        /** The type of source (github or local) */
+        type: z.ZodEnum<["github", "local"]>;
+        /** The original source URL or path */
+        url: z.ZodOptional<z.ZodString>;
+        /** Git reference (tag, branch, commit) for version-controlled sources */
+        ref: z.ZodOptional<z.ZodString>;
+        /** Version from herdctl.json at install time */
+        version: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        /** The type of source (github or local) */
+        type: z.ZodEnum<["github", "local"]>;
+        /** The original source URL or path */
+        url: z.ZodOptional<z.ZodString>;
+        /** Git reference (tag, branch, commit) for version-controlled sources */
+        ref: z.ZodOptional<z.ZodString>;
+        /** Version from herdctl.json at install time */
+        version: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>;
+    /** ISO 8601 timestamp of when the agent was installed */
+    installed_at: z.ZodString;
+    /** herdctl version that performed the installation (e.g., "herdctl@0.5.0") */
+    installed_by: z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    /** Source information - where the agent was installed from */
+    source: z.ZodObject<{
+        /** The type of source (github or local) */
+        type: z.ZodEnum<["github", "local"]>;
+        /** The original source URL or path */
+        url: z.ZodOptional<z.ZodString>;
+        /** Git reference (tag, branch, commit) for version-controlled sources */
+        ref: z.ZodOptional<z.ZodString>;
+        /** Version from herdctl.json at install time */
+        version: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        /** The type of source (github or local) */
+        type: z.ZodEnum<["github", "local"]>;
+        /** The original source URL or path */
+        url: z.ZodOptional<z.ZodString>;
+        /** Git reference (tag, branch, commit) for version-controlled sources */
+        ref: z.ZodOptional<z.ZodString>;
+        /** Version from herdctl.json at install time */
+        version: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        /** The type of source (github or local) */
+        type: z.ZodEnum<["github", "local"]>;
+        /** The original source URL or path */
+        url: z.ZodOptional<z.ZodString>;
+        /** Git reference (tag, branch, commit) for version-controlled sources */
+        ref: z.ZodOptional<z.ZodString>;
+        /** Version from herdctl.json at install time */
+        version: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>;
+    /** ISO 8601 timestamp of when the agent was installed */
+    installed_at: z.ZodString;
+    /** herdctl version that performed the installation (e.g., "herdctl@0.5.0") */
+    installed_by: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    /** Source information - where the agent was installed from */
+    source: z.ZodObject<{
+        /** The type of source (github or local) */
+        type: z.ZodEnum<["github", "local"]>;
+        /** The original source URL or path */
+        url: z.ZodOptional<z.ZodString>;
+        /** Git reference (tag, branch, commit) for version-controlled sources */
+        ref: z.ZodOptional<z.ZodString>;
+        /** Version from herdctl.json at install time */
+        version: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        /** The type of source (github or local) */
+        type: z.ZodEnum<["github", "local"]>;
+        /** The original source URL or path */
+        url: z.ZodOptional<z.ZodString>;
+        /** Git reference (tag, branch, commit) for version-controlled sources */
+        ref: z.ZodOptional<z.ZodString>;
+        /** Version from herdctl.json at install time */
+        version: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        /** The type of source (github or local) */
+        type: z.ZodEnum<["github", "local"]>;
+        /** The original source URL or path */
+        url: z.ZodOptional<z.ZodString>;
+        /** Git reference (tag, branch, commit) for version-controlled sources */
+        ref: z.ZodOptional<z.ZodString>;
+        /** Version from herdctl.json at install time */
+        version: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>;
+    /** ISO 8601 timestamp of when the agent was installed */
+    installed_at: z.ZodString;
+    /** herdctl version that performed the installation (e.g., "herdctl@0.5.0") */
+    installed_by: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;
+/** Type for installation metadata */
+export type InstallationMetadata = z.infer<typeof InstallationMetadataSchema>;
+//# sourceMappingURL=installation-metadata.d.ts.map

package/dist/distribution/installation-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installation-metadata.d.ts","sourceRoot":"","sources":["../../src/distribution/installation-metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,gCAA8B,CAAC;AAE5D,uCAAuC;AACvC,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAM1D;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB;IAEjC,2CAA2C;;IAG3C,sCAAsC;;IAGtC,yEAAyE;;IAGzE,gDAAgD;;;IAThD,2CAA2C;;IAG3C,sCAAsC;;IAGtC,yEAAyE;;IAGzE,gDAAgD;;;IAThD,2CAA2C;;IAG3C,sCAAsC;;IAGtC,yEAAyE;;IAGzE,gDAAgD;;gCAGpC,CAAC;AAEjB,+CAA+C;AAC/C,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAiB1E;;GAEG;AACH,eAAO,MAAM,sBAAsB,aAGjC,CAAC;AAMH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,0BAA0B;IAEnC,8DAA8D;;QApE9D,2CAA2C;;QAG3C,sCAAsC;;QAGtC,yEAAyE;;QAGzE,gDAAgD;;;QAThD,2CAA2C;;QAG3C,sCAAsC;;QAGtC,yEAAyE;;QAGzE,gDAAgD;;;QAThD,2CAA2C;;QAG3C,sCAAsC;;QAGtC,yEAAyE;;QAGzE,gDAAgD;;;IA8DhD,yDAAyD;;IAGzD,8EAA8E;;;IAN9E,8DAA8D;;QApE9D,2CAA2C;;QAG3C,sCAAsC;;QAGtC,yEAAyE;;QAGzE,gDAAgD;;;QAThD,2CAA2C;;QAG3C,sCAAsC;;QAGtC,yEAAyE;;QAGzE,gDAAgD;;;QAThD,2CAA2C;;QAG3C,sCAAsC;;QAGtC,yEAAyE;;QAGzE,gDAAgD;;;IA8DhD,yDAAyD;;IAGzD,8EAA8E;;;IAN9E,8DAA8D;;QApE9D,2CAA2C;;QAG3C,sCAAsC;;QAGtC,yEAAyE;;QAGzE,gDAAgD;;;QAThD,2CAA2C;;QAG3C,sCAAsC;;QAGtC,yEAAyE;;QAGzE,gDAAgD;;;QAThD,2CAA2C;;QAG3C,sCAAsC;;QAGtC,yEAAyE;;QAGzE,gDAAgD;;;IA8DhD,yDAAyD;;IAGzD,8EAA8E;;gCAGlE,CAAC;AAEjB,qCAAqC;AACrC,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}