@alcyone-labs/arg-parser 2.4.2 → 2.6.0

package/README.md

@@ -25,7 +25,9 @@ A modern, type-safe command line argument parser with built-in MCP (Model Contex
     - [Runtime Type Validation](#runtime-type-validation)
     - [Automatic Type Processing](#automatic-type-processing)
     - [Async Custom Parser Support](#async-custom-parser-support)
+    - [Zod Schema Flags (Structured JSON Validation)](#zod-schema-flags-structured-json-validation)
     - [Type Conversion Examples](#type-conversion-examples)
+  - [DXT Package User Configuration & Path Handling](#dxt-package-user-configuration--path-handling)
   - [Hierarchical CLIs (Sub-Commands)](#hierarchical-clis-sub-commands)
     - [MCP Exposure Control](#mcp-exposure-control)
   - [Flag Inheritance (`inheritParentFlags`)](#flag-inheritance-inheritparentflags)
@@ -69,6 +71,10 @@ A modern, type-safe command line argument parser with built-in MCP (Model Contex
   - [Typical Errors](#typical-errors)
 - [System Flags & Configuration](#system-flags--configuration)
 - [Changelog](#changelog)
+  - [v2.6.0](#v260)
+  - [v2.5.0](#v250)
+  - [v2.4.2](#v242)
+  - [v2.4.1](#v241)
   - [v2.4.0](#v240)
   - [v2.3.0](#v230)
   - [v2.2.1](#v221)
@@ -82,69 +88,6 @@ A modern, type-safe command line argument parser with built-in MCP (Model Contex
 - [Backlog](#backlog)
   - [(known) Bugs / DX improvement points](#known-bugs--dx-improvement-points)
 
-- [Features Overview](#features-overview)
-- [Installation](#installation)
-- [Quick Start: The Unified `addTool` API](#quick-start-the-unified-addtool-api)
-- [How to Run It](#how-to-run-it)
-  - [Setting Up System-Wide CLI Access](#setting-up-system-wide-cli-access)
-- [Parsing Command-Line Arguments](#parsing-command-line-arguments)
-  - [Automatic Argument Detection](#automatic-argument-detection)
-  - [Cannonical Usage Pattern](#cannonical-usage-pattern)
-  - [Top-level await](#top-level-await)
-  - [Promise-based parsing](#promise-based-parsing)
-- [Migrating from v1.x to the v2.0 `addTool` API](#migrating-from-v1x-to-the-v20-addtool-api)
-  - [Before v2.0: Separate Definitions](#before-v20-separate-definitions)
-  - [After v2.0: The Unified `addTool()` Method](#after-v20-the-unified-addtool-method)
-- [Core Concepts](#core-concepts)
-  - [Defining Flags](#defining-flags)
-  - [Type Handling and Validation](#type-handling-and-validation)
-    - [Supported Type Formats](#supported-type-formats)
-    - [Runtime Type Validation](#runtime-type-validation)
-    - [Automatic Type Processing](#automatic-type-processing)
-    - [Async Custom Parser Support](#async-custom-parser-support)
-    - [Type Conversion Examples](#type-conversion-examples)
-  - [Hierarchical CLIs (Sub-Commands)](#hierarchical-clis-sub-commands)
-    - [MCP Exposure Control](#mcp-exposure-control)
-  - [Flag Inheritance (`inheritParentFlags`)](#flag-inheritance-inheritparentflags)
-- [MCP & Claude Desktop Integration](#mcp--claude-desktop-integration)
-  - [Output Schema Support](#output-schema-support)
-    - [Basic Usage](#basic-usage)
-    - [Predefined Schema Patterns](#predefined-schema-patterns)
-    - [Custom Zod Schemas](#custom-zod-schemas)
-    - [MCP Version Compatibility](#mcp-version-compatibility)
-    - [Automatic Error Handling](#automatic-error-handling)
-  - [Writing Effective MCP Tool Descriptions](#writing-effective-mcp-tool-descriptions)
-    - [Best Practices for Tool Descriptions](#best-practices-for-tool-descriptions)
-    - [Complete Example: Well-Documented Tool](#complete-example-well-documented-tool)
-    - [Parameter Description Guidelines](#parameter-description-guidelines)
-    - [Common Pitfalls to Avoid](#common-pitfalls-to-avoid)
-  - [Automatic MCP Server Mode (`--s-mcp-serve`)](#automatic-mcp-server-mode---s-mcp-serve)
-  - [MCP Transports](#mcp-transports)
-  - [MCP Log Path Configuration](#mcp-log-path-configuration)
-  - [MCP Resources - Real-Time Data Feeds](#mcp-resources---real-time-data-feeds) ⭐
-  - [Automatic Console Safety](#automatic-console-safety)
-  - [Generating DXT Packages (`--s-build-dxt`)](#generating-dxt-packages---s-build-dxt)
-  - [Logo Configuration](#logo-configuration)
-    - [Supported Logo Sources](#supported-logo-sources)
-  - [How DXT Generation Works](#how-dxt-generation-works)
-  - [DXT Bundling Strategies](#dxt-bundling-strategies)
-    - [Standard Approach (Recommended for Most Projects)](#standard-approach-recommended-for-most-projects)
-    - [Native Dependencies Approach](#native-dependencies-approach)
-- [Typical Errors](#typical-errors)
-- [System Flags & Configuration](#system-flags--configuration)
-- [Changelog](#changelog)
-  - [v2.3.0](#v230)
-  - [v2.2.1](#v221)
-  - [v2.2.0](#v220)
-  - [v2.1.1](#v211)
-  - [v2.1.0](#v210)
-  - [v2.0.0](#v200)
-  - [v1.3.0](#v130)
-  - [v1.2.0](#v120)
-  - [v1.1.0](#v110)
-- [Backlog](#backlog)
-  - [(known) Bugs / DX improvement points](#known-bugs--dx-improvement-points)
-
 ## Features Overview
 
 - **Unified Tool Architecture**: Define tools once with `addTool()` and they automatically function as both CLI subcommands and MCP tools.
@@ -447,7 +390,7 @@ const cli = ArgParser.withMcp({
 // parse() is async and works with both sync and async handlers
 async function main() {
   try {
-    // Option 1: Auto-detection (NEW) - convenient for simple scripts
+    // Option 1: Auto-detection - convenient for simple scripts
     const result = await cli.parse();
 
     // Option 2: Explicit arguments - full control
@@ -604,7 +547,14 @@ Flags are defined using the `IFlag` interface within the `flags` array of a tool
 interface IFlag {
   name: string; // Internal name (e.g., 'verbose')
   options: string[]; // Command-line options (e.g., ['--verbose', '-v'])
-  type: "string" | "number" | "boolean" | "array" | "object" | Function;
+  type:
+    | "string"
+    | "number"
+    | "boolean"
+    | "array"
+    | "object"
+    | Function
+    | ZodSchema;
   description?: string; // Help text
   mandatory?: boolean | ((args: any) => boolean); // Whether the flag is required
   defaultValue?: any; // Default value if not provided
@@ -613,9 +563,153 @@ interface IFlag {
   validate?: (value: any, parsedArgs?: any) => boolean | string | void; // Custom validation function
   allowMultiple?: boolean; // Allow the flag to be provided multiple times
   env?: string; // Links the flag to an environment variable for DXT packages, will automatically generate user_config entries in the DXT manifest and fill the flag value to the ENV value if found (process.env)
+  dxtOptions?: DxtOptions; // Customizes how this flag appears in DXT package user_config
+}
+
+interface DxtOptions {
+  type?: "string" | "directory" | "file" | "boolean" | "number"; // UI input type in Claude Desktop
+  title?: string; // Display name in Claude Desktop (defaults to formatted flag name)
+  sensitive?: boolean; // Whether to hide the value in UI (defaults to true for security)
+  default?: any; // Default value for the user_config entry
+  min?: number; // Minimum value (for number types)
+  max?: number; // Maximum value (for number types)
+}
+```
+
+### DXT Package User Configuration & Path Handling
+
+ArgParser v2.5.0 introduces comprehensive DXT (Desktop Extension Toolkit) support with rich user interfaces, automatic path resolution, and context-aware development tools.
+
+#### Enhanced dxtOptions
+
+When generating DXT packages with `--s-build-dxt`, you can create rich user configuration interfaces using `dxtOptions`:
+
+```typescript
+import { ArgParser, DxtPathResolver } from "@alcyone-labs/arg-parser";
+
+const parser = new ArgParser()
+  .withMcp({
+    name: "file-processor",
+    version: "1.0.0",
+    logPath: "${HOME}/logs/file-processor.log", // DXT variables supported!
+  })
+  .addFlag({
+    name: "input-file",
+    description: "File to process",
+    type: "string",
+    mandatory: true,
+    dxtOptions: {
+      type: "file",
+      title: "Select Input File",
+    },
+  })
+  .addFlag({
+    name: "output-dir",
+    description: "Output directory for processed files",
+    type: "string",
+    dxtOptions: {
+      type: "directory",
+      localDefault: "${DOCUMENTS}/processed-files", // Smart defaults with DXT variables
+      title: "Output Directory",
+    },
+  })
+  .addFlag({
+    name: "api-key",
+    description: "API authentication key",
+    type: "string",
+    env: "API_KEY",
+    dxtOptions: {
+      type: "string",
+      sensitive: true, // Excluded from DXT manifest for security
+      title: "API Key",
+    },
+  })
+  .addFlag({
+    name: "quality",
+    description: "Processing quality (1-100)",
+    type: "number",
+    dxtOptions: {
+      type: "number",
+      min: 1,
+      max: 100,
+      localDefault: 85,
+      title: "Quality (%)",
+    },
+  })
+  .addFlag({
+    name: "parallel",
+    description: "Enable parallel processing",
+    type: "boolean",
+    dxtOptions: {
+      type: "boolean",
+      localDefault: true,
+      title: "Parallel Processing",
+    },
+  });
+```
+
+#### DXT Variables & Path Resolution
+
+ArgParser automatically resolves paths based on your runtime environment:
+
+```typescript
+// DXT variables work everywhere - in flags, MCP config, and code
+const logPath = "${HOME}/logs/app.log";
+const configPath = "${DOCUMENTS}/myapp/config.json";
+const resourcePath = "${__dirname}/templates/default.hbs";
+
+// Helper functions for common patterns
+const userDataPath = DxtPathResolver.createUserDataPath("cache.db");
+const tempPath = DxtPathResolver.createTempPath("processing.tmp");
+const configPath = DxtPathResolver.createConfigPath("settings.json");
+
+// Context detection
+const context = DxtPathResolver.detectContext();
+if (context.isDxt) {
+  console.log("Running in DXT environment");
+} else {
+  console.log("Running in development");
 }
 ```
 
+**Supported DXT Variables:**
+
+- `${HOME}` - User's home directory
+- `${DOCUMENTS}` - Documents folder
+- `${DOWNLOADS}` - Downloads folder
+- `${DESKTOP}` - Desktop folder
+- `${__dirname}` - Entry point directory (DXT package root in DXT)
+- `${pathSeparator}` - Platform-specific path separator
+- `${DXT_DIR}` - DXT package directory (DXT only)
+- `${EXTENSION_DIR}` - Extension root directory (DXT only)
+
+#### dxtOptions Properties
+
+| Property       | Type                                                         | Description                                      |
+| -------------- | ------------------------------------------------------------ | ------------------------------------------------ |
+| `type`         | `'string' \| 'file' \| 'directory' \| 'boolean' \| 'number'` | UI component type                                |
+| `sensitive`    | `boolean`                                                    | Mark as sensitive (excluded from manifest)       |
+| `localDefault` | `string \| number \| boolean`                                | Default for development (supports DXT variables) |
+| `multiple`     | `boolean`                                                    | Allow multiple values                            |
+| `min` / `max`  | `number`                                                     | Validation constraints                           |
+| `title`        | `string`                                                     | Custom display name                              |
+
+#### Security & Best Practices
+
+- **Sensitive Data**: Use `sensitive: true` for passwords, API keys, tokens
+- **Smart Defaults**: Use DXT variables in `localDefault` for portable paths
+- **Type Safety**: Match `dxtOptions.type` with flag `type` for validation
+- **Cross-Platform**: Use `${pathSeparator}` for platform-independent paths
+
+#### Comprehensive Documentation
+
+For detailed guides and examples:
+
+- **[DXT Path Handling Guide](./docs/DXT_PATH_HANDLING.md)** - Complete path resolution guide
+- **[dxtOptions API Documentation](./docs/DXT_OPTIONS_API.md)** - Full API reference with examples
+- **[DXT Migration Guide](./docs/DXT_MIGRATION.md)** - Migrate existing applications
+- **[DXT Practical Examples](./docs/DXT_EXAMPLES.md)** - Real-world usage patterns
+
 ### Type Handling and Validation
 
 ArgParser provides **strong typing** for flag definitions with comprehensive validation at both compile-time and runtime. The `type` property accepts multiple formats and ensures type safety throughout your application.
@@ -756,6 +850,79 @@ const result = await parser.parse(process.argv.slice(2));
 // Async custom parser functions
 --config "./settings.json" → parsed JSON from file (async)
 --user-id "123"            → user data from API (async)
+
+// Zod schema validation (structured JSON)
+--config '{"host":"localhost","port":5432}' → validated object
+--deployment '{"env":"prod","region":"us-east-1"}' → validated object
+```
+
+#### Zod Schema Flags (Structured JSON Validation)
+
+**Since v2.5.0** - You can now use Zod schemas as flag types for structured JSON input with automatic validation and proper MCP JSON Schema generation:
+
+```typescript
+import { z } from "zod";
+
+const DatabaseConfigSchema = z.object({
+  host: z.string().describe("Database host address"),
+  port: z.number().min(1).max(65535).describe("Database port number"),
+  credentials: z.object({
+    username: z.string().describe("Database username"),
+    password: z.string().describe("Database password"),
+  }),
+  ssl: z.boolean().optional().describe("Enable SSL connection"),
+});
+
+const cli = ArgParser.withMcp({
+  appName: "Database CLI",
+  appCommandName: "db-cli",
+}).addTool({
+  name: "connect",
+  description: "Connect to database with structured configuration",
+  flags: [
+    {
+      name: "config",
+      options: ["--config", "-c"],
+      type: DatabaseConfigSchema, // 🎉 Zod schema as type!
+      description: "Database configuration as JSON object",
+      mandatory: true,
+    },
+  ],
+  handler: async (ctx) => {
+    // ctx.args.config is fully typed and validated!
+    const { host, port, credentials, ssl } = ctx.args.config;
+    console.log(`Connecting to ${host}:${port} as ${credentials.username}`);
+    return { success: true };
+  },
+});
+
+// CLI usage with JSON validation:
+// db-cli connect --config '{"host":"localhost","port":5432,"credentials":{"username":"admin","password":"secret"},"ssl":true}'
+
+// MCP usage: Generates proper JSON Schema for MCP clients
+// db-cli --s-mcp-serve
+```
+
+**Example with Complex Nested Schema:**
+
+```typescript
+const DeploymentSchema = z.object({
+  environment: z.enum(["dev", "staging", "prod"]),
+  region: z.string(),
+  scaling: z.object({
+    minInstances: z.number().min(1),
+    maxInstances: z.number().min(1),
+    targetCpu: z.number().min(10).max(100),
+  }),
+  monitoring: z.object({
+    enabled: z.boolean(),
+    alertEmail: z.string().email().optional(),
+    metrics: z.array(z.string()),
+  }),
+});
+
+// This generates comprehensive JSON Schema for MCP clients
+// while providing full validation and type safety for CLI usage
 ```
 
 ### Hierarchical CLIs (Sub-Commands)
@@ -1329,9 +1496,9 @@ const cli = ArgParser.withMcp({
         ctx.logger.mcpError(`Shutting down: ${ctx.reason}`);
         await cleanupResources();
         await closeDatabase();
-      }
-    }
-  }
+      },
+    },
+  },
 });
 ```
 
@@ -1344,6 +1511,7 @@ const cli = ArgParser.withMcp({
 **Context Properties:**
 
 Each lifecycle event receives a context object with:
+
 - `getFlag(name)`: Access parsed CLI flags and environment variables
 - `logger`: MCP-compliant logger instance for the current context
 - `serverInfo`: Server information (name, version, description)
@@ -1746,6 +1914,54 @@ ArgParser includes built-in `--s-*` flags for development, debugging, and config
 
 ## Changelog
 
+### v2.6.0
+
+**Feat**
+
+**DXT**:
+
+- Improve how paths and dynamic variables are handled when bundling into a DXT, to improve compatibility and reduce paths that will fail in a sandbox when the CLI / MCP expects path available on the system. Dynamic path resolution with `${VARIABLE}` syntax supporting `${HOME}`, `${DOCUMENTS}`, `${__dirname}`, `${DXT_DIR}`, and more. Context-aware path resolution with `DxtPathResolver.createUserDataPath()`, `createTempPath()`, `createConfigPath()`.
+- Add new IFlag.dxtOption set of options for each flag to allow finer control on how the flags are perceived on the DXT manifest / Claude Desktop.
+
+Read more her: [DXT Package User Configuration & Path Handling](#dxt-package-user-configuration--path-handling)
+
+**Fixes and Changes**
+
+**DXT**:
+
+- Improve handling of sensitive env variable, they were previously always showing as sensitive.
+
+**Known Limitations**
+
+**DXT**:
+
+The DXT bundling / packing / unpacking / launching process is notoriously early and brittle. There are many reasons something is not working, but **MOST** importantly it will not work if:
+
+1. You are bundling a package in a mono-repo (you will need to temporarily create a pnpm-workspace.yaml file for example to break the hierarchy)
+2. You do _not_ hard-install your node_modules as detailed in the documentation (it will only work if the node_modules are hard installed)
+3. In some cases if your CLI entrypoint does not run a main loop (see documentation for working examples)
+4. If you use PATH-dependent variables (for example relying on ~/.config/path/to/some.json). This has been addressed in v2.6.0, but you have to make sure you use the correct patterns (see documentation)
+
+### v2.5.0
+
+**Feat**
+
+- **Zod Schema Flags**: You can now use Zod schemas as flag types for structured JSON input validation. This enables complex object validation with automatic JSON Schema generation for MCP clients while maintaining full type safety and CLI compatibility.
+- **Improved MCP Tool Documentation**: Zod schema descriptions automatically become MCP tool parameter documentation
+
+### v2.4.2
+
+**Fixes and Changes**
+
+- add missing MCP lifecycle event documentation
+- fix the behavior of the withMcp() options.mcp.log that was not working as expected
+
+### v2.4.1
+
+**Fixes and Changes**
+
+- switch to NPM version of @alcyone-labs/modelcontextprotocol-sdk to freeze the dependency and avoid side-effects
+
 ### v2.4.0
 
 **Feat**
@@ -1754,7 +1970,7 @@ ArgParser includes built-in `--s-*` flags for development, debugging, and config
 - MCP client now sanitizes the method names to ensure spec-compliants MCP behavior, names that collision will be logged
 - There were some use-cases where the DXT bundling failed, this new release addresses all of them, namely:
   1. Output structure will match that of the input so relative files (for example DB migrations) will work
-  2.
+  2. Deeper folder structure was previously not working
 - DXT bundling now supports including resources via options: `{dxt: {include: ['TSDown blob-like paths']}`
 - Logger was improved to support log level via `options:{ log: {} }` so you can set it to level: 'debug' and the MCP log will contain 100% of the console output, logPath setting was not impacted
 
@@ -1848,8 +2064,8 @@ Make sure to clearly identify if you need to include the node_modules or not. In
 - [x] Upgrade to Zod/V4 (V4 does not support functions well, this will take more time, not a priority)
 - [ ] Add System flags to args.systemArgs
 - [ ] Improve flag options collision prevention
-- [ ] Add support for locales / translations
 - [ ] (potentially) add support for fully typed parsed output, this has proven very challenging
+- [ ] Add support for locales / translations
 
 ### (known) Bugs / DX improvement points
 

package/dist/core/ArgParserBase.d.ts.map

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

package/dist/core/FlagManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FlagManager.d.ts","sourceRoot":"","sources":["../../src/core/FlagManager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEpD,qBAAa,WAAW;;gBAKpB,OAAO,GAAE;QAAE,sBAAsB,CAAC,EAAE,OAAO,CAAA;KAAO,EAClD,YAAY,GAAE,SAAS,KAAK,EAAO;IAMrC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,GAAG,aAAa;IAyC5C,OAAO,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI;IAoB1B,+BAA+B,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI;IAQnE,QAAQ,CAAC,KAAK,EAAE,SAAS,KAAK,EAAE,GAAG,IAAI;IAOvC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIhD,IAAI,KAAK,IAAI,aAAa,EAAE,CAE3B;IAED,IAAI,SAAS,IAAI,MAAM,EAAE,CAExB;CACF"}
+{"version":3,"file":"FlagManager.d.ts","sourceRoot":"","sources":["../../src/core/FlagManager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEpD,qBAAa,WAAW;;gBAKpB,OAAO,GAAE;QAAE,sBAAsB,CAAC,EAAE,OAAO,CAAA;KAAO,EAClD,YAAY,GAAE,SAAS,KAAK,EAAO;IAMrC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,GAAG,aAAa;IA0C5C,OAAO,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI;IAoB1B,+BAA+B,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI;IAQnE,QAAQ,CAAC,KAAK,EAAE,SAAS,KAAK,EAAE,GAAG,IAAI;IAOvC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIhD,IAAI,KAAK,IAAI,aAAa,EAAE,CAE3B;IAED,IAAI,SAAS,IAAI,MAAM,EAAE,CAExB;CACF"}

package/dist/core/dxt-path-resolver.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Context information for path resolution
+ */
+export interface IPathContext {
+    /** Whether the code is running in a DXT environment */
+    isDxt: boolean;
+    /** DXT extension directory (when running in DXT) */
+    extensionDir?: string;
+    /** User's home directory */
+    userHome?: string;
+    /** Current working directory */
+    cwd?: string;
+    /** Entry point directory */
+    entryDir?: string;
+}
+/**
+ * Configuration for DXT variable substitution
+ */
+export interface IDxtVariableConfig {
+    /** Custom variable values to override defaults */
+    customVariables?: Record<string, string>;
+    /** Whether to allow undefined variables (default: false) */
+    allowUndefined?: boolean;
+}
+/**
+ * DXT-aware path resolver with context detection and variable substitution
+ */
+export declare class DxtPathResolver {
+    private static _cachedContext;
+    /**
+     * Detects the current execution context
+     * @param forceRefresh - Force refresh of cached context
+     * @returns Path context information
+     */
+    static detectContext(forceRefresh?: boolean): IPathContext;
+    /**
+     * Checks if the current environment is a DXT environment
+     * @returns True if running in DXT, false otherwise
+     */
+    static isDxtEnvironment(): boolean;
+    /**
+     * Detects the DXT extension directory
+     * @returns DXT extension directory path or undefined
+     */
+    private static detectDxtExtensionDir;
+    /**
+     * Resolves a path with DXT variable substitution
+     * @param inputPath - Path that may contain DXT variables
+     * @param context - Optional context (will be detected if not provided)
+     * @param config - Optional configuration for variable substitution
+     * @returns Resolved absolute path
+     */
+    static resolvePath(inputPath: string, context?: IPathContext, config?: IDxtVariableConfig): string;
+    /**
+     * Substitutes DXT variables in a path string
+     * @param inputPath - Path containing variables like ${HOME}, ${__dirname}, etc.
+     * @param context - Path context
+     * @param config - Variable substitution configuration
+     * @returns Path with variables substituted
+     */
+    static substituteVariables(inputPath: string, context: IPathContext, config?: IDxtVariableConfig): string;
+    /**
+     * Creates a path for user data storage
+     * @param filename - Name of the file or subdirectory
+     * @param context - Optional context (will be detected if not provided)
+     * @returns Absolute path for user data
+     */
+    static createUserDataPath(filename: string, context?: IPathContext): string;
+    /**
+     * Creates a path for temporary files
+     * @param filename - Name of the temporary file
+     * @param context - Optional context (will be detected if not provided)
+     * @returns Absolute path for temporary file
+     */
+    static createTempPath(filename: string, context?: IPathContext): string;
+    /**
+     * Creates a path for configuration files
+     * @param filename - Name of the configuration file
+     * @param context - Optional context (will be detected if not provided)
+     * @returns Absolute path for configuration file
+     */
+    static createConfigPath(filename: string, context?: IPathContext): string;
+    /**
+     * Gets the application name for directory creation
+     * @param context - Path context
+     * @returns Application name or default
+     */
+    private static getAppName;
+    /**
+     * Ensures a directory exists, creating it if necessary
+     * @param dirPath - Directory path to ensure
+     * @returns True if directory exists or was created successfully
+     */
+    static ensureDirectory(dirPath: string): boolean;
+    /**
+     * Clears the cached context (useful for testing)
+     */
+    static clearCache(): void;
+}
+//# sourceMappingURL=dxt-path-resolver.d.ts.map

package/dist/core/dxt-path-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dxt-path-resolver.d.ts","sourceRoot":"","sources":["../../src/core/dxt-path-resolver.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,KAAK,EAAE,OAAO,CAAC;IACf,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,4DAA4D;IAC5D,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,cAAc,CAA6B;IAE1D;;;;OAIG;WACW,aAAa,CAAC,YAAY,UAAQ,GAAG,YAAY;IA0B/D;;;OAGG;WACW,gBAAgB,IAAI,OAAO;IAwCzC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IA6BpC;;;;;;OAMG;WACW,WAAW,CACvB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,YAAY,EACtB,MAAM,CAAC,EAAE,kBAAkB,GAC1B,MAAM;IAmBT;;;;;;OAMG;WACW,mBAAmB,CAC/B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,YAAY,EACrB,MAAM,CAAC,EAAE,kBAAkB,GAC1B,MAAM;IAuDT;;;;;OAKG;WACW,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM;IAgBlF;;;;;OAKG;WACW,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM;IAc9E;;;;;OAKG;WACW,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM;IAgBhF;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;IAezB;;;;OAIG;WACW,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAYvD;;OAEG;WACW,UAAU,IAAI,IAAI;CAGjC"}

package/dist/core/log-path-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log-path-utils.d.ts","sourceRoot":"","sources":["../../src/core/log-path-utils.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,UAAU,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,UAAU,CAAC;IAC1C,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,aAAa,CAAC;AAE7C;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CA0BhD;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAMzE;AAYD;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,OAAO,EAChB,kBAAkB,CAAC,EAAE,MAAM,GAC1B,MAAM,CAkER;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAKzD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAKvD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,aAAa,CAM3E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD"}
+{"version":3,"file":"log-path-utils.d.ts","sourceRoot":"","sources":["../../src/core/log-path-utils.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,UAAU,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,UAAU,CAAC;IAC1C,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,aAAa,CAAC;AAE7C;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CA0BhD;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAMzE;AAYD;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,OAAO,EAChB,kBAAkB,CAAC,EAAE,MAAM,GAC1B,MAAM,CAiFR;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAKzD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAKvD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,aAAa,CAM3E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD"}