@enactprotocol/shared 2.0.0 → 2.0.1

package/dist/manifest/validator.js

@@ -0,0 +1,258 @@
+/**
+ * Manifest validator using Zod
+ *
+ * Validates that parsed manifests conform to the Enact specification
+ */
+import { z } from "zod/v4";
+// ==================== Zod Schemas ====================
+/**
+ * Environment variable schema
+ */
+const EnvVariableSchema = z.object({
+    description: z.string().min(1, "Description is required"),
+    secret: z.boolean().optional(),
+    default: z.string().optional(),
+});
+/**
+ * Author schema
+ */
+const AuthorSchema = z.object({
+    name: z.string().min(1, "Author name is required"),
+    email: z.string().email().optional(),
+    url: z.string().url().optional(),
+});
+/**
+ * Tool annotations schema
+ */
+const ToolAnnotationsSchema = z.object({
+    title: z.string().optional(),
+    readOnlyHint: z.boolean().optional(),
+    destructiveHint: z.boolean().optional(),
+    idempotentHint: z.boolean().optional(),
+    openWorldHint: z.boolean().optional(),
+});
+/**
+ * Resource requirements schema
+ */
+const ResourceRequirementsSchema = z.object({
+    memory: z.string().optional(),
+    gpu: z.string().optional(),
+    disk: z.string().optional(),
+});
+/**
+ * Tool example schema
+ */
+const ToolExampleSchema = z.object({
+    input: z.record(z.string(), z.unknown()).optional(),
+    output: z.unknown().optional(),
+    description: z.string().optional(),
+});
+/**
+ * JSON Schema validation (basic structure check)
+ * We don't fully validate JSON Schema here, just ensure it's an object
+ */
+const JsonSchemaSchema = z
+    .object({
+    type: z.string().optional(),
+    properties: z.record(z.string(), z.unknown()).optional(),
+    required: z.array(z.string()).optional(),
+    items: z.unknown().optional(),
+    enum: z.array(z.unknown()).optional(),
+    description: z.string().optional(),
+})
+    .passthrough(); // Allow additional JSON Schema fields
+/**
+ * Semantic version regex
+ */
+const SEMVER_REGEX = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/;
+/**
+ * Tool name regex - hierarchical path format
+ */
+const TOOL_NAME_REGEX = /^[a-z0-9_-]+(?:\/[a-z0-9_-]+)+$/;
+/**
+ * Go duration regex (used for timeout)
+ */
+const GO_DURATION_REGEX = /^(\d+)(ns|us|µs|ms|s|m|h)$/;
+/**
+ * Complete tool manifest schema
+ */
+const ToolManifestSchema = z
+    .object({
+    // Required fields
+    name: z
+        .string()
+        .min(1, "Tool name is required")
+        .regex(TOOL_NAME_REGEX, "Tool name must be hierarchical path format (e.g., 'org/tool' or 'org/category/tool')"),
+    description: z
+        .string()
+        .min(1, "Description is required")
+        .max(500, "Description should be 500 characters or less"),
+    // Recommended fields
+    enact: z.string().optional(),
+    version: z
+        .string()
+        .regex(SEMVER_REGEX, "Version must be valid semver (e.g., '1.0.0')")
+        .optional(),
+    from: z.string().optional(),
+    command: z.string().optional(),
+    timeout: z
+        .string()
+        .regex(GO_DURATION_REGEX, "Timeout must be Go duration format (e.g., '30s', '5m', '1h')")
+        .optional(),
+    license: z.string().optional(),
+    tags: z.array(z.string()).optional(),
+    // Schema fields
+    inputSchema: JsonSchemaSchema.optional(),
+    outputSchema: JsonSchemaSchema.optional(),
+    // Environment variables
+    env: z.record(z.string(), EnvVariableSchema).optional(),
+    // Behavior & Resources
+    annotations: ToolAnnotationsSchema.optional(),
+    resources: ResourceRequirementsSchema.optional(),
+    // Documentation
+    doc: z.string().optional(),
+    authors: z.array(AuthorSchema).optional(),
+    // Testing
+    examples: z.array(ToolExampleSchema).optional(),
+})
+    .passthrough(); // Allow x-* custom fields
+// ==================== Validation Functions ====================
+/**
+ * Convert Zod error to our ValidationError format
+ */
+function zodErrorToValidationErrors(zodError) {
+    return zodError.issues.map((issue) => ({
+        path: issue.path.join("."),
+        message: issue.message,
+        code: issue.code,
+    }));
+}
+/**
+ * Generate warnings for recommended but missing fields
+ */
+function generateWarnings(manifest) {
+    const warnings = [];
+    // Check for recommended fields
+    if (!manifest.enact) {
+        warnings.push({
+            path: "enact",
+            message: "Protocol version (enact) is recommended for compatibility",
+            code: "MISSING_RECOMMENDED",
+        });
+    }
+    if (!manifest.version) {
+        warnings.push({
+            path: "version",
+            message: "Tool version is recommended for versioning and updates",
+            code: "MISSING_RECOMMENDED",
+        });
+    }
+    if (!manifest.from && manifest.command) {
+        warnings.push({
+            path: "from",
+            message: "Container image (from) is recommended for reproducibility",
+            code: "MISSING_RECOMMENDED",
+        });
+    }
+    if (!manifest.license) {
+        warnings.push({
+            path: "license",
+            message: "License is recommended for published tools",
+            code: "MISSING_RECOMMENDED",
+        });
+    }
+    if (!manifest.inputSchema && manifest.command) {
+        warnings.push({
+            path: "inputSchema",
+            message: "Input schema is recommended for tools with parameters",
+            code: "MISSING_RECOMMENDED",
+        });
+    }
+    if (!manifest.outputSchema) {
+        warnings.push({
+            path: "outputSchema",
+            message: "Output schema is recommended for structured output validation",
+            code: "MISSING_RECOMMENDED",
+        });
+    }
+    // Check for potential issues
+    if (manifest.env) {
+        for (const [key, value] of Object.entries(manifest.env)) {
+            if (value.secret && value.default) {
+                warnings.push({
+                    path: `env.${key}`,
+                    message: "Secret variables should not have default values",
+                    code: "SECRET_WITH_DEFAULT",
+                });
+            }
+        }
+    }
+    // Check for timeout on command tools
+    if (manifest.command && !manifest.timeout) {
+        warnings.push({
+            path: "timeout",
+            message: "Timeout is recommended for command-based tools",
+            code: "MISSING_RECOMMENDED",
+        });
+    }
+    return warnings;
+}
+/**
+ * Validate a tool manifest
+ *
+ * @param manifest - The manifest to validate (parsed but unvalidated)
+ * @returns ValidationResult with valid flag, errors, and warnings
+ */
+export function validateManifest(manifest) {
+    const result = ToolManifestSchema.safeParse(manifest);
+    if (!result.success) {
+        return {
+            valid: false,
+            errors: zodErrorToValidationErrors(result.error),
+            warnings: [],
+        };
+    }
+    // Generate warnings for missing recommended fields
+    const warnings = generateWarnings(result.data);
+    return {
+        valid: true,
+        warnings: warnings.length > 0 ? warnings : undefined,
+    };
+}
+/**
+ * Validate and return the typed manifest
+ * Throws if validation fails
+ *
+ * @param manifest - The manifest to validate
+ * @returns The validated ToolManifest
+ * @throws Error if validation fails
+ */
+export function validateManifestStrict(manifest) {
+    const result = validateManifest(manifest);
+    if (!result.valid) {
+        const errorMessages = result.errors?.map((e) => `${e.path}: ${e.message}`).join(", ");
+        throw new Error(`Manifest validation failed: ${errorMessages}`);
+    }
+    return manifest;
+}
+/**
+ * Check if a string is a valid tool name
+ */
+export function isValidToolName(name) {
+    return TOOL_NAME_REGEX.test(name);
+}
+/**
+ * Check if a string is a valid semver version
+ */
+export function isValidVersion(version) {
+    return SEMVER_REGEX.test(version);
+}
+/**
+ * Check if a string is a valid Go duration
+ */
+export function isValidTimeout(timeout) {
+    return GO_DURATION_REGEX.test(timeout);
+}
+// Export the schema for external use
+export { ToolManifestSchema };
+//# sourceMappingURL=validator.js.map

package/dist/manifest/validator.js.map

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

package/dist/paths.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Path resolution utilities for Enact directories and tool locations
+ */
+/**
+ * Scope for tool directories
+ */
+export type ToolScope = "user" | "project";
+/**
+ * Get the Enact home directory (~/.enact/)
+ * @returns Absolute path to ~/.enact/
+ */
+export declare function getEnactHome(): string;
+/**
+ * Get the project-level .enact directory
+ * Searches up from current working directory to find .enact/
+ * NOTE: Does NOT return ~/.enact/ - that's the global home, not a project dir
+ * @param startDir - Directory to start searching from (defaults to cwd)
+ * @returns Absolute path to .enact/ or null if not found
+ */
+export declare function getProjectEnactDir(startDir?: string): string | null;
+/**
+ * Get the tools directory for specified scope
+ *
+ * NOTE: For global scope ("user"), this is DEPRECATED.
+ * Global tools are now tracked in ~/.enact/tools.json and stored in cache.
+ * Use getToolsJsonPath("global") and getToolCachePath() from ./registry instead.
+ *
+ * For project scope, this returns .enact/tools/ where project tools are copied.
+ *
+ * @param scope - 'user' for ~/.enact/tools/ (deprecated) or 'project' for .enact/tools/
+ * @param startDir - For project scope, directory to start searching from
+ * @returns Absolute path to tools directory or null if project scope and not found
+ * @deprecated Use registry.ts functions for global tools
+ */
+export declare function getToolsDir(scope: ToolScope, startDir?: string): string | null;
+/**
+ * Get the cache directory (~/.enact/cache/)
+ * @returns Absolute path to ~/.enact/cache/
+ */
+export declare function getCacheDir(): string;
+/**
+ * Get the configuration file path (~/.enact/config.yaml)
+ * @returns Absolute path to ~/.enact/config.yaml
+ */
+export declare function getConfigPath(): string;
+/**
+ * Get the global .env file path (~/.enact/.env)
+ * @returns Absolute path to ~/.enact/.env
+ */
+export declare function getGlobalEnvPath(): string;
+/**
+ * Get the project .env file path (.enact/.env)
+ * @param startDir - Directory to start searching from
+ * @returns Absolute path to .enact/.env or null if not found
+ */
+export declare function getProjectEnvPath(startDir?: string): string | null;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AAE3C;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoBnE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS9E;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGlE"}

package/dist/paths.js

@@ -0,0 +1,93 @@
+/**
+ * Path resolution utilities for Enact directories and tool locations
+ */
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+/**
+ * Get the Enact home directory (~/.enact/)
+ * @returns Absolute path to ~/.enact/
+ */
+export function getEnactHome() {
+    return join(homedir(), ".enact");
+}
+/**
+ * Get the project-level .enact directory
+ * Searches up from current working directory to find .enact/
+ * NOTE: Does NOT return ~/.enact/ - that's the global home, not a project dir
+ * @param startDir - Directory to start searching from (defaults to cwd)
+ * @returns Absolute path to .enact/ or null if not found
+ */
+export function getProjectEnactDir(startDir) {
+    let currentDir = resolve(startDir ?? process.cwd());
+    const root = resolve("/");
+    const enactHome = getEnactHome();
+    // Walk up directory tree looking for .enact/
+    while (currentDir !== root) {
+        const enactDir = join(currentDir, ".enact");
+        // Skip ~/.enact/ - that's the global home, not a project directory
+        if (existsSync(enactDir) && enactDir !== enactHome) {
+            return enactDir;
+        }
+        const parentDir = resolve(currentDir, "..");
+        if (parentDir === currentDir) {
+            break; // Reached root
+        }
+        currentDir = parentDir;
+    }
+    return null;
+}
+/**
+ * Get the tools directory for specified scope
+ *
+ * NOTE: For global scope ("user"), this is DEPRECATED.
+ * Global tools are now tracked in ~/.enact/tools.json and stored in cache.
+ * Use getToolsJsonPath("global") and getToolCachePath() from ./registry instead.
+ *
+ * For project scope, this returns .enact/tools/ where project tools are copied.
+ *
+ * @param scope - 'user' for ~/.enact/tools/ (deprecated) or 'project' for .enact/tools/
+ * @param startDir - For project scope, directory to start searching from
+ * @returns Absolute path to tools directory or null if project scope and not found
+ * @deprecated Use registry.ts functions for global tools
+ */
+export function getToolsDir(scope, startDir) {
+    if (scope === "user") {
+        // DEPRECATED: Global tools now use tools.json + cache
+        // This path is kept for backward compatibility during migration
+        return join(getEnactHome(), "tools");
+    }
+    const projectDir = getProjectEnactDir(startDir);
+    return projectDir ? join(projectDir, "tools") : null;
+}
+/**
+ * Get the cache directory (~/.enact/cache/)
+ * @returns Absolute path to ~/.enact/cache/
+ */
+export function getCacheDir() {
+    return join(getEnactHome(), "cache");
+}
+/**
+ * Get the configuration file path (~/.enact/config.yaml)
+ * @returns Absolute path to ~/.enact/config.yaml
+ */
+export function getConfigPath() {
+    return join(getEnactHome(), "config.yaml");
+}
+/**
+ * Get the global .env file path (~/.enact/.env)
+ * @returns Absolute path to ~/.enact/.env
+ */
+export function getGlobalEnvPath() {
+    return join(getEnactHome(), ".env");
+}
+/**
+ * Get the project .env file path (.enact/.env)
+ * @param startDir - Directory to start searching from
+ * @returns Absolute path to .enact/.env or null if not found
+ */
+export function getProjectEnvPath(startDir) {
+    const projectDir = getProjectEnactDir(startDir);
+    return projectDir ? join(projectDir, ".env") : null;
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAO1C;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAiB;IAClD,IAAI,UAAU,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1B,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IAEjC,6CAA6C;IAC7C,OAAO,UAAU,KAAK,IAAI,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC5C,mEAAmE;QACnE,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YACnD,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC5C,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;YAC7B,MAAM,CAAC,eAAe;QACxB,CAAC;QACD,UAAU,GAAG,SAAS,CAAC;IACzB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,WAAW,CAAC,KAAgB,EAAE,QAAiB;IAC7D,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACrB,sDAAsD;QACtD,gEAAgE;QAChE,OAAO,IAAI,CAAC,YAAY,EAAE,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,UAAU,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAChD,OAAO,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACvD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,IAAI,CAAC,YAAY,EAAE,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,CAAC,YAAY,EAAE,EAAE,aAAa,CAAC,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,IAAI,CAAC,YAAY,EAAE,EAAE,MAAM,CAAC,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAiB;IACjD,MAAM,UAAU,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAChD,OAAO,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACtD,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Local tool registry management
+ *
+ * Manages tools.json files for tracking installed tools:
+ * - Global: ~/.enact/tools.json (installed with -g)
+ * - Project: .enact/tools.json (project dependencies)
+ *
+ * Tools are stored in cache and referenced by version in tools.json.
+ * This eliminates the need for a separate ~/.enact/tools/ directory.
+ */
+/**
+ * Structure of tools.json file
+ */
+export interface ToolsRegistry {
+    /** Map of tool name to installed version */
+    tools: Record<string, string>;
+}
+/**
+ * Scope for tool registry
+ */
+export type RegistryScope = "global" | "project";
+/**
+ * Information about an installed tool
+ */
+export interface InstalledToolInfo {
+    name: string;
+    version: string;
+    scope: RegistryScope;
+    cachePath: string;
+}
+/**
+ * Get the path to tools.json for the specified scope
+ */
+export declare function getToolsJsonPath(scope: RegistryScope, startDir?: string): string | null;
+/**
+ * Load tools.json from the specified scope
+ * Returns empty registry if file doesn't exist
+ */
+export declare function loadToolsRegistry(scope: RegistryScope, startDir?: string): ToolsRegistry;
+/**
+ * Save tools.json to the specified scope
+ */
+export declare function saveToolsRegistry(registry: ToolsRegistry, scope: RegistryScope, startDir?: string): void;
+/**
+ * Add a tool to the registry
+ */
+export declare function addToolToRegistry(toolName: string, version: string, scope: RegistryScope, startDir?: string): void;
+/**
+ * Remove a tool from the registry
+ */
+export declare function removeToolFromRegistry(toolName: string, scope: RegistryScope, startDir?: string): boolean;
+/**
+ * Check if a tool is installed in the registry
+ */
+export declare function isToolInstalled(toolName: string, scope: RegistryScope, startDir?: string): boolean;
+/**
+ * Get the installed version of a tool
+ * Returns null if not installed
+ */
+export declare function getInstalledVersion(toolName: string, scope: RegistryScope, startDir?: string): string | null;
+/**
+ * Get the cache path for an installed tool
+ */
+export declare function getToolCachePath(toolName: string, version: string): string;
+/**
+ * List all installed tools in a registry
+ */
+export declare function listInstalledTools(scope: RegistryScope, startDir?: string): InstalledToolInfo[];
+/**
+ * Get tool info if installed (checks cache path exists)
+ */
+export declare function getInstalledToolInfo(toolName: string, scope: RegistryScope, startDir?: string): InstalledToolInfo | null;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOvF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,aAAa,CAiBxF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,aAAa,EACvB,KAAK,EAAE,aAAa,EACpB,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI,CAuBN;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,aAAa,EACpB,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI,CAIN;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,EACpB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAUT;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,EACpB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAGT;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,EACpB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CAGf;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAI1E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAc/F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,EACpB,QAAQ,CAAC,EAAE,MAAM,GAChB,iBAAiB,GAAG,IAAI,CAoB1B"}

package/dist/registry.js

@@ -0,0 +1,147 @@
+/**
+ * Local tool registry management
+ *
+ * Manages tools.json files for tracking installed tools:
+ * - Global: ~/.enact/tools.json (installed with -g)
+ * - Project: .enact/tools.json (project dependencies)
+ *
+ * Tools are stored in cache and referenced by version in tools.json.
+ * This eliminates the need for a separate ~/.enact/tools/ directory.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { getCacheDir, getEnactHome, getProjectEnactDir } from "./paths";
+/**
+ * Get the path to tools.json for the specified scope
+ */
+export function getToolsJsonPath(scope, startDir) {
+    if (scope === "global") {
+        return join(getEnactHome(), "tools.json");
+    }
+    const projectDir = getProjectEnactDir(startDir);
+    return projectDir ? join(projectDir, "tools.json") : null;
+}
+/**
+ * Load tools.json from the specified scope
+ * Returns empty registry if file doesn't exist
+ */
+export function loadToolsRegistry(scope, startDir) {
+    const registryPath = getToolsJsonPath(scope, startDir);
+    if (!registryPath || !existsSync(registryPath)) {
+        return { tools: {} };
+    }
+    try {
+        const content = readFileSync(registryPath, "utf-8");
+        const parsed = JSON.parse(content);
+        return {
+            tools: parsed.tools ?? {},
+        };
+    }
+    catch {
+        // Return empty registry on parse error
+        return { tools: {} };
+    }
+}
+/**
+ * Save tools.json to the specified scope
+ */
+export function saveToolsRegistry(registry, scope, startDir) {
+    let registryPath = getToolsJsonPath(scope, startDir);
+    // For project scope, create .enact/ directory if it doesn't exist
+    if (!registryPath && scope === "project") {
+        const projectRoot = startDir ?? process.cwd();
+        const enactDir = join(projectRoot, ".enact");
+        mkdirSync(enactDir, { recursive: true });
+        registryPath = join(enactDir, "tools.json");
+    }
+    if (!registryPath) {
+        throw new Error("Cannot save project registry: unable to determine registry path");
+    }
+    // Ensure directory exists
+    const dir = dirname(registryPath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    const content = JSON.stringify(registry, null, 2);
+    writeFileSync(registryPath, content, "utf-8");
+}
+/**
+ * Add a tool to the registry
+ */
+export function addToolToRegistry(toolName, version, scope, startDir) {
+    const registry = loadToolsRegistry(scope, startDir);
+    registry.tools[toolName] = version;
+    saveToolsRegistry(registry, scope, startDir);
+}
+/**
+ * Remove a tool from the registry
+ */
+export function removeToolFromRegistry(toolName, scope, startDir) {
+    const registry = loadToolsRegistry(scope, startDir);
+    if (!(toolName in registry.tools)) {
+        return false;
+    }
+    delete registry.tools[toolName];
+    saveToolsRegistry(registry, scope, startDir);
+    return true;
+}
+/**
+ * Check if a tool is installed in the registry
+ */
+export function isToolInstalled(toolName, scope, startDir) {
+    const registry = loadToolsRegistry(scope, startDir);
+    return toolName in registry.tools;
+}
+/**
+ * Get the installed version of a tool
+ * Returns null if not installed
+ */
+export function getInstalledVersion(toolName, scope, startDir) {
+    const registry = loadToolsRegistry(scope, startDir);
+    return registry.tools[toolName] ?? null;
+}
+/**
+ * Get the cache path for an installed tool
+ */
+export function getToolCachePath(toolName, version) {
+    const cacheDir = getCacheDir();
+    const normalizedVersion = version.startsWith("v") ? version.slice(1) : version;
+    return join(cacheDir, toolName, `v${normalizedVersion}`);
+}
+/**
+ * List all installed tools in a registry
+ */
+export function listInstalledTools(scope, startDir) {
+    const registry = loadToolsRegistry(scope, startDir);
+    const tools = [];
+    for (const [name, version] of Object.entries(registry.tools)) {
+        tools.push({
+            name,
+            version,
+            scope,
+            cachePath: getToolCachePath(name, version),
+        });
+    }
+    return tools;
+}
+/**
+ * Get tool info if installed (checks cache path exists)
+ */
+export function getInstalledToolInfo(toolName, scope, startDir) {
+    const version = getInstalledVersion(toolName, scope, startDir);
+    if (!version) {
+        return null;
+    }
+    const cachePath = getToolCachePath(toolName, version);
+    // Verify cache exists
+    if (!existsSync(cachePath)) {
+        return null;
+    }
+    return {
+        name: toolName,
+        version,
+        scope,
+        cachePath,
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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