@enactprotocol/shared 1.2.13 → 2.0.1

package/dist/types.d.ts

@@ -1,132 +1,5 @@
-export interface EnactTool {
-    name: string;
-    description: string;
-    command: string;
-    from?: string;
-    timeout?: string;
-    tags?: string[];
-    license?: string;
-    outputSchema?: JSONSchemaDefinition;
-    enact?: string;
-    version?: string;
-    namespace?: string;
-    resources?: {
-        memory?: string;
-        gpu?: string;
-        disk?: string;
-    };
-    env?: Record<string, {
-        description: string;
-        source: string;
-        required: boolean;
-        default?: string;
-    }>;
-    inputSchema?: JSONSchemaDefinition;
-    doc?: string;
-    authors?: Array<{
-        name: string;
-        email?: string;
-        url?: string;
-    }>;
-    examples?: Array<{
-        input: Record<string, any>;
-        output?: any;
-        description?: string;
-    }>;
-    annotations?: {
-        title?: string;
-        readOnlyHint?: boolean;
-        destructiveHint?: boolean;
-        idempotentHint?: boolean;
-        openWorldHint?: boolean;
-    };
-    signature?: {
-        algorithm: string;
-        type: string;
-        signer: string;
-        created: string;
-        value: string;
-        role?: string;
-    };
-    signatures?: {
-        signer: string;
-        algorithm: string;
-        type: string;
-        value: string;
-        created: string;
-        role?: string;
-    }[];
-    [key: string]: any;
-}
-export interface JSONSchemaDefinition {
-    type?: string | string[];
-    description?: string;
-    format?: string;
-    default?: any;
-    enum?: any[];
-    const?: any;
-    pattern?: string;
-    minLength?: number;
-    maxLength?: number;
-    minimum?: number;
-    maximum?: number;
-    exclusiveMinimum?: number;
-    exclusiveMaximum?: number;
-    multipleOf?: number;
-    items?: JSONSchemaDefinition | JSONSchemaDefinition[];
-    minItems?: number;
-    maxItems?: number;
-    uniqueItems?: boolean;
-    properties?: Record<string, JSONSchemaDefinition>;
-    required?: string[];
-    additionalProperties?: JSONSchemaDefinition | boolean;
-    allOf?: JSONSchemaDefinition[];
-    anyOf?: JSONSchemaDefinition[];
-    oneOf?: JSONSchemaDefinition[];
-    not?: JSONSchemaDefinition;
-    definitions?: Record<string, JSONSchemaDefinition>;
-    $ref?: string;
-    $id?: string;
-    $schema?: string;
-    [key: string]: any;
-}
-export interface ExecutionResult {
-    success: boolean;
-    output?: any;
-    error?: {
-        message: string;
-        code?: string;
-        details?: any;
-    };
-    metadata: {
-        executionId: string;
-        toolName: string;
-        version?: string;
-        executedAt: string;
-        environment: string;
-        timeout?: string;
-        command?: string;
-    };
-}
-export interface ExecutionEnvironment {
-    vars: Record<string, any>;
-    resources?: {
-        memory?: string;
-        gpu?: string;
-        disk?: string;
-        timeout?: string;
-    };
-    namespace?: string;
-    mount?: string;
-}
-export declare abstract class ExecutionProvider {
-    abstract setup(tool: EnactTool): Promise<boolean>;
-    abstract execute(tool: EnactTool, inputs: Record<string, any>, environment: ExecutionEnvironment): Promise<ExecutionResult>;
-    abstract cleanup(): Promise<boolean>;
-    abstract resolveEnvironmentVariables(envConfig: Record<string, any>, namespace?: string): Promise<Record<string, any>>;
-    abstract executeCommand(command: string, inputs: Record<string, any>, environment: ExecutionEnvironment, timeout?: string): Promise<{
-        stdout: string;
-        stderr: string;
-        exitCode: number;
-    }>;
-}
+/**
+ * Type definitions for shared utilities
+ */
+export type EnactManifest = Record<string, unknown>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC"}

package/dist/types.js

@@ -1,3 +1,5 @@
-// Updated execution provider interface
-export class ExecutionProvider {
-}
+/**
+ * Type definitions for shared utilities
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/utils/fs.d.ts

@@ -0,0 +1,105 @@
+/**
+ * @enactprotocol/shared - File system helpers
+ *
+ * Provides utilities for common filesystem operations.
+ */
+/**
+ * Ensure a directory exists, creating it if necessary
+ */
+export declare function ensureDir(dirPath: string): void;
+/**
+ * Ensure the parent directory of a file exists
+ */
+export declare function ensureParentDir(filePath: string): void;
+/**
+ * Check if a path exists
+ */
+export declare function pathExists(path: string): boolean;
+/**
+ * Check if a path is a directory
+ */
+export declare function isDirectory(path: string): boolean;
+/**
+ * Check if a path is a file
+ */
+export declare function isFile(path: string): boolean;
+/**
+ * Read and parse a JSON file
+ * @throws Error if file doesn't exist or isn't valid JSON
+ */
+export declare function readJsonFile<T = unknown>(filePath: string): T;
+/**
+ * Try to read and parse a JSON file
+ * @returns The parsed JSON or null if file doesn't exist or is invalid
+ */
+export declare function tryReadJsonFile<T = unknown>(filePath: string): T | null;
+/**
+ * Write data to a JSON file with formatting
+ */
+export declare function writeJsonFile(filePath: string, data: unknown, options?: {
+    indent?: number | undefined;
+}): void;
+/**
+ * Read a text file
+ */
+export declare function readTextFile(filePath: string): string;
+/**
+ * Try to read a text file
+ * @returns The file content or null if file doesn't exist
+ */
+export declare function tryReadTextFile(filePath: string): string | null;
+/**
+ * Write content to a text file
+ */
+export declare function writeTextFile(filePath: string, content: string): void;
+/**
+ * Copy a file
+ */
+export declare function copyFile(src: string, dest: string): void;
+/**
+ * Copy a directory recursively
+ */
+export declare function copyDir(src: string, dest: string): void;
+/**
+ * Remove a file or directory
+ */
+export declare function remove(path: string): void;
+/**
+ * List directory contents
+ */
+export declare function listDir(dirPath: string): string[];
+/**
+ * List directory entries with types
+ */
+export declare function listDirEntries(dirPath: string): Array<{
+    name: string;
+    type: "file" | "directory" | "unknown";
+    path: string;
+}>;
+/**
+ * Find files matching a pattern in a directory (non-recursive)
+ */
+export declare function findFiles(dirPath: string, pattern: RegExp | string): string[];
+/**
+ * Find files recursively
+ */
+export declare function findFilesRecursive(dirPath: string, pattern?: RegExp | string): string[];
+/**
+ * Get file stats
+ */
+export declare function getStats(path: string): {
+    size: number;
+    isFile: boolean;
+    isDirectory: boolean;
+    created: Date;
+    modified: Date;
+} | null;
+/**
+ * Get file size in bytes
+ */
+export declare function getFileSize(filePath: string): number | null;
+/**
+ * Touch a file (create if not exists, update mtime if exists)
+ */
+export declare function touchFile(filePath: string): void;
+//# sourceMappingURL=fs.d.ts.map

package/dist/utils/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAI/C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAGtD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMjD;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAM5C;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,CAG7D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAMvE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACxC,IAAI,CAIN;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM/D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAGrE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAGxD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAevD;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAIzC;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAKjD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;CACd,CAAC,CAWD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAO7E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CA4BvF;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,IAAI,CAAC;IACd,QAAQ,EAAE,IAAI,CAAC;CAChB,GAAG,IAAI,CAaP;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG3D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAQhD"}

package/dist/utils/fs.js

@@ -0,0 +1,233 @@
+/**
+ * @enactprotocol/shared - File system helpers
+ *
+ * Provides utilities for common filesystem operations.
+ */
+import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync, } from "node:fs";
+import { dirname, join } from "node:path";
+/**
+ * Ensure a directory exists, creating it if necessary
+ */
+export function ensureDir(dirPath) {
+    if (!existsSync(dirPath)) {
+        mkdirSync(dirPath, { recursive: true });
+    }
+}
+/**
+ * Ensure the parent directory of a file exists
+ */
+export function ensureParentDir(filePath) {
+    const parentDir = dirname(filePath);
+    ensureDir(parentDir);
+}
+/**
+ * Check if a path exists
+ */
+export function pathExists(path) {
+    return existsSync(path);
+}
+/**
+ * Check if a path is a directory
+ */
+export function isDirectory(path) {
+    try {
+        return existsSync(path) && statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if a path is a file
+ */
+export function isFile(path) {
+    try {
+        return existsSync(path) && statSync(path).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Read and parse a JSON file
+ * @throws Error if file doesn't exist or isn't valid JSON
+ */
+export function readJsonFile(filePath) {
+    const content = readFileSync(filePath, "utf-8");
+    return JSON.parse(content);
+}
+/**
+ * Try to read and parse a JSON file
+ * @returns The parsed JSON or null if file doesn't exist or is invalid
+ */
+export function tryReadJsonFile(filePath) {
+    try {
+        return readJsonFile(filePath);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write data to a JSON file with formatting
+ */
+export function writeJsonFile(filePath, data, options) {
+    const indent = options?.indent ?? 2;
+    ensureParentDir(filePath);
+    writeFileSync(filePath, `${JSON.stringify(data, null, indent)}\n`, "utf-8");
+}
+/**
+ * Read a text file
+ */
+export function readTextFile(filePath) {
+    return readFileSync(filePath, "utf-8");
+}
+/**
+ * Try to read a text file
+ * @returns The file content or null if file doesn't exist
+ */
+export function tryReadTextFile(filePath) {
+    try {
+        return readTextFile(filePath);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write content to a text file
+ */
+export function writeTextFile(filePath, content) {
+    ensureParentDir(filePath);
+    writeFileSync(filePath, content, "utf-8");
+}
+/**
+ * Copy a file
+ */
+export function copyFile(src, dest) {
+    ensureParentDir(dest);
+    copyFileSync(src, dest);
+}
+/**
+ * Copy a directory recursively
+ */
+export function copyDir(src, dest) {
+    ensureDir(dest);
+    const entries = readdirSync(src, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = join(src, entry.name);
+        const destPath = join(dest, entry.name);
+        if (entry.isDirectory()) {
+            copyDir(srcPath, destPath);
+        }
+        else {
+            copyFile(srcPath, destPath);
+        }
+    }
+}
+/**
+ * Remove a file or directory
+ */
+export function remove(path) {
+    if (existsSync(path)) {
+        rmSync(path, { recursive: true, force: true });
+    }
+}
+/**
+ * List directory contents
+ */
+export function listDir(dirPath) {
+    if (!existsSync(dirPath)) {
+        return [];
+    }
+    return readdirSync(dirPath);
+}
+/**
+ * List directory entries with types
+ */
+export function listDirEntries(dirPath) {
+    if (!existsSync(dirPath)) {
+        return [];
+    }
+    const entries = readdirSync(dirPath, { withFileTypes: true });
+    return entries.map((entry) => ({
+        name: entry.name,
+        type: entry.isDirectory() ? "directory" : entry.isFile() ? "file" : "unknown",
+        path: join(dirPath, entry.name),
+    }));
+}
+/**
+ * Find files matching a pattern in a directory (non-recursive)
+ */
+export function findFiles(dirPath, pattern) {
+    const entries = listDir(dirPath);
+    const regex = typeof pattern === "string" ? new RegExp(pattern) : pattern;
+    return entries
+        .filter((name) => regex.test(name) && isFile(join(dirPath, name)))
+        .map((name) => join(dirPath, name));
+}
+/**
+ * Find files recursively
+ */
+export function findFilesRecursive(dirPath, pattern) {
+    const results = [];
+    if (!existsSync(dirPath)) {
+        return results;
+    }
+    const regex = pattern !== undefined ? (typeof pattern === "string" ? new RegExp(pattern) : pattern) : null;
+    function walk(dir) {
+        const entries = readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                walk(fullPath);
+            }
+            else if (entry.isFile()) {
+                if (!regex || regex.test(entry.name)) {
+                    results.push(fullPath);
+                }
+            }
+        }
+    }
+    walk(dirPath);
+    return results;
+}
+/**
+ * Get file stats
+ */
+export function getStats(path) {
+    try {
+        const stats = statSync(path);
+        return {
+            size: stats.size,
+            isFile: stats.isFile(),
+            isDirectory: stats.isDirectory(),
+            created: stats.birthtime,
+            modified: stats.mtime,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get file size in bytes
+ */
+export function getFileSize(filePath) {
+    const stats = getStats(filePath);
+    return stats?.isFile ? stats.size : null;
+}
+/**
+ * Touch a file (create if not exists, update mtime if exists)
+ */
+export function touchFile(filePath) {
+    ensureParentDir(filePath);
+    if (existsSync(filePath)) {
+        // Update access and modification time by rewriting the file
+        writeFileSync(filePath, readFileSync(filePath));
+    }
+    else {
+        writeFileSync(filePath, "", "utf-8");
+    }
+}
+//# sourceMappingURL=fs.js.map

package/dist/utils/fs.js.map

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

package/dist/utils/logger.d.ts

@@ -1,35 +1,112 @@
-export declare enum LogLevel {
-    DEBUG = 0,
-    INFO = 1,
-    SUCCESS = 2,
-    WARN = 3,
-    ERROR = 4
-}
-/**
- * Sets the current log level
- */
-export declare function setLogLevel(level: LogLevel): void;
-/**
- * Debug log - only shown when log level is DEBUG
- */
-export declare function debug(message: string): void;
 /**
- * Info log - general information
+ * @enactprotocol/shared - Logger utility
+ *
+ * Provides structured logging with level filtering and
+ * configurable output formats (console with colors or JSON).
  */
-export declare function info(message: string): void;
+export type LogLevel = "debug" | "info" | "warn" | "error" | "silent";
+export interface LogEntry {
+    timestamp: string;
+    level: LogLevel;
+    message: string;
+    context?: Record<string, unknown> | undefined;
+}
+export interface LoggerOptions {
+    /** Minimum level to output */
+    level?: LogLevel;
+    /** Output format: 'console' for colored output, 'json' for structured */
+    format?: "console" | "json";
+    /** Enable colors in console output */
+    colors?: boolean;
+    /** Custom output function (defaults to console) */
+    output?: (text: string) => void;
+    /** Custom error output function (defaults to console.error) */
+    errorOutput?: (text: string) => void;
+    /** Prefix for log messages */
+    prefix?: string;
+}
 /**
- * Success log - operation completed successfully
+ * Logger class with level filtering and structured output
  */
-export declare function success(message: string): void;
+export declare class Logger {
+    private level;
+    private format;
+    private colors;
+    private output;
+    private errorOutput;
+    private prefix;
+    constructor(options?: LoggerOptions);
+    /**
+     * Check if a level should be logged
+     */
+    shouldLog(level: LogLevel): boolean;
+    /**
+     * Set the minimum log level
+     */
+    setLevel(level: LogLevel): void;
+    /**
+     * Get the current log level
+     */
+    getLevel(): LogLevel;
+    /**
+     * Set the output format
+     */
+    setFormat(format: "console" | "json"): void;
+    /**
+     * Enable or disable colors
+     */
+    setColors(enabled: boolean): void;
+    /**
+     * Set the prefix for log messages
+     */
+    setPrefix(prefix: string): void;
+    /**
+     * Create a child logger with a prefix
+     */
+    child(prefix: string): Logger;
+    /**
+     * Log a debug message
+     */
+    debug(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log an info message
+     */
+    info(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log a warning message
+     */
+    warn(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log an error message
+     */
+    error(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Core logging method
+     */
+    private log;
+    /**
+     * Format entry as JSON
+     */
+    private formatJson;
+    /**
+     * Format entry for console with colors
+     */
+    private formatConsole;
+}
 /**
- * Warning log - non-critical issues
+ * Get the default logger instance
  */
-export declare function warn(message: string): void;
+export declare function getLogger(): Logger;
 /**
- * Error log - critical issues
+ * Configure the default logger
  */
-export declare function error(message: string, details?: any): void;
+export declare function configureLogger(options: LoggerOptions): void;
 /**
- * Table log - display tabular data
+ * Create a new logger with the given options
  */
-export declare function table(data: any[], columns?: string[]): void;
+export declare function createLogger(options?: LoggerOptions): Logger;
+export declare const debug: (message: string, context?: Record<string, unknown>) => void;
+export declare const info: (message: string, context?: Record<string, unknown>) => void;
+export declare const warn: (message: string, context?: Record<string, unknown>) => void;
+export declare const error: (message: string, context?: Record<string, unknown>) => void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

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