cc-agentic-framework 1.14.1

package/dist/lib/command-factory.js

@@ -0,0 +1,166 @@
+import { Command, Option } from "commander";
+/**
+ * Create a Commander.js command from configuration
+ * @param config - Command configuration
+ * @returns Commander.js Command instance
+ */
+export function createSkillCommand(config) {
+    const command = new Command(config.name);
+    // Set description
+    command.description(config.description);
+    // Add metadata for skill tracking
+    command.setOptionValue("_skillId", config.skill);
+    command.setOptionValue("_commandType", config.type);
+    // Add options
+    for (const opt of config.options) {
+        addCommandOption(command, opt);
+    }
+    // Add action if provided
+    if (config.action) {
+        command.action(config.action);
+    }
+    return command;
+}
+/**
+ * Add an option to a command
+ */
+function addCommandOption(command, opt) {
+    // Build option flags
+    let flags;
+    // Add short flag if it makes sense (first letter of option name)
+    const shortFlag = opt.name.charAt(0);
+    flags = `-${shortFlag}, --${opt.name}`;
+    // Add value placeholder if not a boolean
+    if (opt.required !== undefined || opt.default !== undefined) {
+        flags += ` <${opt.name}>`;
+    }
+    // Create option
+    const option = new Option(flags, opt.description);
+    // Add default value if provided
+    if (opt.default !== undefined) {
+        option.default(opt.default);
+    }
+    // Add choices if provided
+    if (opt.choices && opt.choices.length > 0) {
+        option.choices(opt.choices);
+    }
+    // Make required if specified
+    if (opt.required) {
+        option.makeOptionMandatory();
+    }
+    command.addOption(option);
+}
+/**
+ * Create a 'create' command (for generating files from templates)
+ */
+export function createCreateCommand(name, description, skill, options, action) {
+    return createSkillCommand({
+        name,
+        description,
+        type: "create",
+        skill,
+        options,
+        action,
+    });
+}
+/**
+ * Create a 'validate' command (for validating files)
+ */
+export function createValidateCommand(name, description, skill, options, action) {
+    return createSkillCommand({
+        name,
+        description,
+        type: "validate",
+        skill,
+        options,
+        action,
+    });
+}
+/**
+ * Create a 'sync' command (for synchronizing data)
+ */
+export function createSyncCommand(name, description, skill, options, action) {
+    return createSkillCommand({
+        name,
+        description,
+        type: "sync",
+        skill,
+        options,
+        action,
+    });
+}
+/**
+ * Create a 'transform' command (for transforming files)
+ */
+export function createTransformCommand(name, description, skill, options, action) {
+    return createSkillCommand({
+        name,
+        description,
+        type: "transform",
+        skill,
+        options,
+        action,
+    });
+}
+/**
+ * Parse command options from CLI arguments
+ * Useful for testing and programmatic command execution
+ */
+export function parseCommandOptions(command, args) {
+    // Parse arguments
+    command.parse(args, { from: "user" });
+    // Return parsed options
+    return command.opts();
+}
+/**
+ * Get skill ID from a command
+ */
+export function getCommandSkillId(command) {
+    return command.getOptionValue("_skillId");
+}
+/**
+ * Get command type from a command
+ */
+export function getCommandType(command) {
+    return command.getOptionValue("_commandType");
+}
+/**
+ * Validate command configuration
+ */
+export function validateCommandConfig(config) {
+    if (!config.name) {
+        throw new Error("Command configuration must have a name");
+    }
+    if (!config.description) {
+        throw new Error("Command configuration must have a description");
+    }
+    if (!config.type) {
+        throw new Error("Command configuration must have a type");
+    }
+    if (!config.skill) {
+        throw new Error("Command configuration must have a skill");
+    }
+    if (!Array.isArray(config.options)) {
+        throw new Error("Command configuration options must be an array");
+    }
+    // Validate each option
+    for (const opt of config.options) {
+        if (!opt.name) {
+            throw new Error("Command option must have a name");
+        }
+        if (!opt.description) {
+            throw new Error("Command option must have a description");
+        }
+    }
+    return true;
+}
+/**
+ * Create multiple commands from configurations
+ */
+export function createCommands(configs) {
+    return configs.map((config) => {
+        validateCommandConfig(config);
+        return createSkillCommand(config);
+    });
+}
+//# sourceMappingURL=command-factory.js.map

package/dist/lib/command-factory.js.map

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

package/dist/lib/common/api-client.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Authentication configuration for API client
+ */
+export interface AuthConfig {
+    type: 'basic' | 'bearer' | 'custom';
+    credentials: string | {
+        username: string;
+        password: string;
+    };
+}
+/**
+ * Rate limiting configuration
+ */
+export interface RateLimitConfig {
+    maxRequests: number;
+    perMilliseconds: number;
+}
+/**
+ * API client configuration
+ */
+export interface ApiClientConfig {
+    baseUrl: string;
+    auth?: AuthConfig;
+    timeout?: number;
+    retries?: number;
+    retryDelay?: number;
+    rateLimit?: RateLimitConfig;
+}
+/**
+ * Request options for individual API calls
+ */
+export interface RequestOptions {
+    params?: Record<string, unknown>;
+    headers?: Record<string, string>;
+    timeout?: number;
+}
+/**
+ * Custom API error class with structured error information
+ */
+export declare class ApiError extends Error {
+    status?: number;
+    statusText?: string;
+    data?: unknown;
+    constructor(message: string, status?: number, statusText?: string, data?: unknown);
+}
+/**
+ * HTTP API client with retry logic, rate limiting, and error handling
+ */
+export declare class ApiClient {
+    private axiosInstance;
+    private config;
+    private requestQueue;
+    private requestTimestamps;
+    constructor(config: ApiClientConfig);
+    /**
+     * Enforce rate limiting if configured
+     */
+    private enforceRateLimit;
+    /**
+     * Sleep for specified milliseconds
+     */
+    private sleep;
+    /**
+     * Handle API errors and convert to ApiError
+     */
+    private handleError;
+    /**
+     * Determine if an error is retryable
+     */
+    private isRetryableError;
+    /**
+     * Execute request with retry logic
+     */
+    private executeWithRetry;
+    /**
+     * Make GET request
+     */
+    get<T = unknown>(path: string, options?: RequestOptions): Promise<T>;
+    /**
+     * Make POST request
+     */
+    post<T = unknown>(path: string, data: unknown, options?: RequestOptions): Promise<T>;
+    /**
+     * Make PUT request
+     */
+    put<T = unknown>(path: string, data: unknown, options?: RequestOptions): Promise<T>;
+    /**
+     * Make DELETE request
+     */
+    delete<T = unknown>(path: string, options?: RequestOptions): Promise<T>;
+}
+//# sourceMappingURL=api-client.d.ts.map

package/dist/lib/common/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../../src/lib/common/api-client.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACpC,WAAW,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9D;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;CAOlF;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,iBAAiB,CAAgB;gBAE7B,MAAM,EAAE,eAAe;IAiCnC;;OAEG;YACW,gBAAgB;IA2B9B;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,OAAO,CAAC,WAAW;IAiCnB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkBxB;;OAEG;YACW,gBAAgB;IA0B9B;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,CAAC,CAAC;IAa9E;;OAEG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,CAAC,CAAC;IAa9F;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,CAAC,CAAC;IAa7F;;OAEG;IACG,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,CAAC,CAAC;CAYlF"}

package/dist/lib/common/api-client.js

@@ -0,0 +1,206 @@
+import axios from 'axios';
+/**
+ * Custom API error class with structured error information
+ */
+export class ApiError extends Error {
+    status;
+    statusText;
+    data;
+    constructor(message, status, statusText, data) {
+        super(message);
+        this.name = 'ApiError';
+        this.status = status;
+        this.statusText = statusText;
+        this.data = data;
+    }
+}
+/**
+ * HTTP API client with retry logic, rate limiting, and error handling
+ */
+export class ApiClient {
+    axiosInstance;
+    config;
+    requestQueue = [];
+    requestTimestamps = [];
+    constructor(config) {
+        this.config = {
+            timeout: 30000,
+            retries: 0,
+            retryDelay: 1000,
+            ...config,
+            baseUrl: config.baseUrl.replace(/\/$/, ''), // Strip trailing slash
+        };
+        // Create axios instance with base configuration
+        const axiosConfig = {
+            baseURL: this.config.baseUrl,
+            timeout: this.config.timeout,
+        };
+        // Configure basic auth if provided
+        if (this.config.auth?.type === 'basic') {
+            const creds = this.config.auth.credentials;
+            axiosConfig.auth = creds;
+        }
+        this.axiosInstance = axios.create(axiosConfig);
+        // Configure bearer or custom auth headers
+        if (this.config.auth?.type === 'bearer') {
+            const token = this.config.auth.credentials;
+            this.axiosInstance.defaults.headers.common['Authorization'] = `Bearer ${token}`;
+        }
+        else if (this.config.auth?.type === 'custom') {
+            const token = this.config.auth.credentials;
+            this.axiosInstance.defaults.headers.common['Authorization'] = token;
+        }
+    }
+    /**
+     * Enforce rate limiting if configured
+     */
+    async enforceRateLimit() {
+        if (!this.config.rateLimit) {
+            return;
+        }
+        const now = Date.now();
+        const { maxRequests, perMilliseconds } = this.config.rateLimit;
+        // Remove timestamps outside the time window
+        this.requestTimestamps = this.requestTimestamps.filter((timestamp) => now - timestamp < perMilliseconds);
+        // If we've hit the rate limit, wait
+        if (this.requestTimestamps.length >= maxRequests) {
+            const oldestTimestamp = this.requestTimestamps[0];
+            const waitTime = perMilliseconds - (now - oldestTimestamp);
+            await this.sleep(waitTime);
+            // Recursively check again
+            return this.enforceRateLimit();
+        }
+        // Record this request
+        this.requestTimestamps.push(now);
+    }
+    /**
+     * Sleep for specified milliseconds
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * Handle API errors and convert to ApiError
+     */
+    handleError(error) {
+        // Check if it's an axios error (or mock error with axios-like structure)
+        const isAxiosLike = axios.isAxiosError(error) || error.isAxiosError === true;
+        if (isAxiosLike) {
+            const axiosError = error;
+            // Handle timeout errors
+            if (axiosError.code === 'ECONNABORTED') {
+                throw new ApiError('Request timeout');
+            }
+            // Handle network errors
+            if (axiosError.code === 'ENOTFOUND' || axiosError.code === 'ECONNREFUSED') {
+                throw new ApiError('Network error');
+            }
+            // Handle response errors
+            if (axiosError.response) {
+                const { status, statusText, data } = axiosError.response;
+                const message = data?.message || statusText || 'Request failed';
+                throw new ApiError(message, status, statusText, data);
+            }
+            // Handle request errors
+            throw new ApiError(axiosError.message);
+        }
+        // Handle non-axios errors
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        throw new ApiError(errorMessage);
+    }
+    /**
+     * Determine if an error is retryable
+     */
+    isRetryableError(error) {
+        const isAxiosLike = axios.isAxiosError(error) || error.isAxiosError === true;
+        if (!isAxiosLike) {
+            return false;
+        }
+        const axiosError = error;
+        if (!axiosError.response) {
+            return false;
+        }
+        const status = axiosError.response.status;
+        // Retry on rate limit and server errors
+        return status === 429 || status === 500 || status === 502 || status === 503 || status === 504;
+    }
+    /**
+     * Execute request with retry logic
+     */
+    async executeWithRetry(requestFn, attempt = 0) {
+        try {
+            return await requestFn();
+        }
+        catch (error) {
+            const shouldRetry = this.isRetryableError(error);
+            const maxRetries = this.config.retries || 0;
+            if (shouldRetry && attempt < maxRetries) {
+                // Calculate exponential backoff delay
+                const baseDelay = this.config.retryDelay || 1000;
+                const delay = baseDelay * Math.pow(2, attempt);
+                await this.sleep(delay);
+                // Retry the request
+                return this.executeWithRetry(requestFn, attempt + 1);
+            }
+            // No more retries or non-retryable error - convert to ApiError
+            this.handleError(error);
+        }
+    }
+    /**
+     * Make GET request
+     */
+    async get(path, options = {}) {
+        await this.enforceRateLimit();
+        return this.executeWithRetry(async () => {
+            const response = await this.axiosInstance.get(path, {
+                params: options.params,
+                headers: options.headers,
+                timeout: options.timeout,
+            });
+            return response.data;
+        });
+    }
+    /**
+     * Make POST request
+     */
+    async post(path, data, options = {}) {
+        await this.enforceRateLimit();
+        return this.executeWithRetry(async () => {
+            const response = await this.axiosInstance.post(path, data, {
+                params: options.params,
+                headers: options.headers,
+                timeout: options.timeout,
+            });
+            return response.data;
+        });
+    }
+    /**
+     * Make PUT request
+     */
+    async put(path, data, options = {}) {
+        await this.enforceRateLimit();
+        return this.executeWithRetry(async () => {
+            const response = await this.axiosInstance.put(path, data, {
+                params: options.params,
+                headers: options.headers,
+                timeout: options.timeout,
+            });
+            return response.data;
+        });
+    }
+    /**
+     * Make DELETE request
+     */
+    async delete(path, options = {}) {
+        await this.enforceRateLimit();
+        return this.executeWithRetry(async () => {
+            const response = await this.axiosInstance.delete(path, {
+                params: options.params,
+                headers: options.headers,
+                timeout: options.timeout,
+            });
+            return response.data;
+        });
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/lib/common/api-client.js.map

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

package/dist/lib/common/file-utils.d.ts

@@ -0,0 +1,92 @@
+/**
+ * File system utilities for safe file operations
+ *
+ * Provides async helpers with proper encoding and error handling.
+ * Based on Python's pathlib-based file_utils.py from the core framework.
+ */
+/**
+ * Safely read file contents
+ *
+ * @param filePath - Path to file
+ * @param encoding - File encoding (default: utf-8)
+ * @returns File contents as string
+ * @throws {Error} If file doesn't exist or read fails
+ *
+ * @example
+ * ```typescript
+ * const content = await safeRead('/path/to/file.txt');
+ * ```
+ */
+export declare function safeRead(filePath: string, encoding?: BufferEncoding): Promise<string>;
+/**
+ * Safely write content to file
+ *
+ * Creates parent directories if they don't exist.
+ *
+ * @param filePath - Path to file
+ * @param content - Content to write
+ * @param encoding - File encoding (default: utf-8)
+ * @throws {Error} If write fails
+ *
+ * @example
+ * ```typescript
+ * await safeWrite('/path/to/file.txt', 'Hello, World!');
+ * ```
+ */
+export declare function safeWrite(filePath: string, content: string, encoding?: BufferEncoding): Promise<void>;
+/**
+ * Ensure directory exists, create if needed
+ *
+ * Creates parent directories recursively if they don't exist.
+ *
+ * @param dirPath - Path to directory
+ *
+ * @example
+ * ```typescript
+ * await ensureDirectory('/path/to/nested/directory');
+ * ```
+ */
+export declare function ensureDirectory(dirPath: string): Promise<void>;
+/**
+ * Check if a path exists (file or directory)
+ *
+ * @param path - Path to check
+ * @returns True if path exists, false otherwise
+ *
+ * @example
+ * ```typescript
+ * if (await fileExists('/path/to/file.txt')) {
+ *   console.log('File exists!');
+ * }
+ * ```
+ */
+export declare function fileExists(path: string): Promise<boolean>;
+/**
+ * Check if a path is a directory
+ *
+ * @param path - Path to check
+ * @returns True if path exists and is a directory, false otherwise
+ *
+ * @example
+ * ```typescript
+ * if (await isDirectory('/path/to/dir')) {
+ *   console.log('It is a directory!');
+ * }
+ * ```
+ */
+export declare function isDirectory(path: string): Promise<boolean>;
+/**
+ * Check if a path is a file
+ *
+ * @param path - Path to check
+ * @returns True if path exists and is a file, false otherwise
+ *
+ * @example
+ * ```typescript
+ * if (await isFile('/path/to/file.txt')) {
+ *   console.log('It is a file!');
+ * }
+ * ```
+ */
+export declare function isFile(path: string): Promise<boolean>;
+//# sourceMappingURL=file-utils.d.ts.map

package/dist/lib/common/file-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-utils.d.ts","sourceRoot":"","sources":["../../../src/lib/common/file-utils.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,cAAwB,GACjC,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,cAAwB,GACjC,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE/D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOhE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO3D"}