@isdk/ai-tool 0.8.2 → 0.9.0

package/docs/api/functions/isStrWrapped.md

@@ -8,7 +8,9 @@
 
 > **isStrWrapped**(`s`, `pairs`): `boolean`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/parse-command.ts:200](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/parse-command.ts#L200)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/utils.ts:96](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/utils.ts#L96)
+
+Checks if a string is wrapped by specified character pairs.
 
 ## Parameters
 

package/docs/api/functions/isSubdirectory.md

@@ -8,7 +8,7 @@
 
 > **isSubdirectory**(`parentDir`, `childDir`): `boolean`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/has-directory-in.ts:17](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/has-directory-in.ts#L17)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/has-directory-in.ts:17](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/has-directory-in.ts#L17)
 
 Determines whether the `childDir` is a subdirectory of `parentDir`.
 

package/docs/api/functions/isTitleString.md

@@ -6,9 +6,9 @@
 
 # Function: isTitleString()
 
-> **isTitleString**(`text`, `options?`): `null` \| `RegExpExecArray`
+> **isTitleString**(`text`, `options?`): `RegExpExecArray` \| `null`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/split-sentence.ts:204](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/split-sentence.ts#L204)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/split-sentence.ts:204](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/split-sentence.ts#L204)
 
 ## Parameters
 
@@ -22,4 +22,4 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/split-sentence.ts:204](ht
 
 ## Returns
 
-`null` \| `RegExpExecArray`
+`RegExpExecArray` \| `null`

package/docs/api/functions/isValidFilename.md

@@ -8,7 +8,7 @@
 
 > **isValidFilename**(`filename`): `boolean` \| `""`
 
-Defined in: @isdk/util/dist/index.d.ts:400
+Defined in: @isdk/util/dist/index.d.ts:401
 
 Validates if a given string is a valid filename.
 

package/docs/api/functions/isValidFilepath.md

@@ -8,7 +8,7 @@
 
 > **isValidFilepath**(`filepath`): `boolean`
 
-Defined in: @isdk/util/dist/index.d.ts:406
+Defined in: @isdk/util/dist/index.d.ts:407
 
 Validates whether the given filepath is valid.
 

package/docs/api/functions/isWebStream.md

@@ -8,7 +8,7 @@
 
 > **isWebStream**(`val`): val is ReadableStream\<any\> \| WritableStream\<any\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/stream/is-web-stream.ts:1](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/stream/is-web-stream.ts#L1)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/stream/is-web-stream.ts:1](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/stream/is-web-stream.ts#L1)
 
 ## Parameters
 

package/docs/api/functions/joinSplitWords.md

@@ -8,7 +8,7 @@
 
 > **joinSplitWords**(`input`, `separator`): `string`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/split-words.ts:18](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/split-words.ts#L18)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/split-words.ts:18](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/split-words.ts#L18)
 
 Splits a string into words using splitWords rules, then joins them with a separator
 

package/docs/api/functions/jsonFilterToWhere.md

@@ -8,7 +8,7 @@
 
 > **jsonFilterToWhere**(`filter`, `wrapKey?`): `string`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/json-filter.ts:123](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/json-filter.ts#L123)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/json-filter.ts:123](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/json-filter.ts#L123)
 
 Converts a filter object to a SQLite WHERE clause.
 

package/docs/api/functions/jsonToMarkdownStr.md

@@ -8,7 +8,7 @@
 
 > **jsonToMarkdownStr**(`mem`, `options?`): `string`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/json-to-markdown-str.ts:2](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/json-to-markdown-str.ts#L2)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/json-to-markdown-str.ts:2](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/json-to-markdown-str.ts#L2)
 
 ## Parameters
 

package/docs/api/functions/loadAIConfig.md

@@ -8,7 +8,7 @@
 
 > **loadAIConfig**(`config`): `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/load-config.ts:58](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/load-config.ts#L58)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/load-config.ts:58](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/load-config.ts#L58)
 
 ## Parameters
 

package/docs/api/functions/loadConfig.md

@@ -8,7 +8,7 @@
 
 > **loadConfig**(`filename`, `config`): `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/load-config.ts:30](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/load-config.ts#L30)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/load-config.ts:30](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/load-config.ts#L30)
 
 ## Parameters
 

package/docs/api/functions/loadConfigFile.md

@@ -8,7 +8,7 @@
 
 > **loadConfigFile**(`filename`, `searchPaths`): `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/load-config.ts:9](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/load-config.ts#L9)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/load-config.ts:9](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/load-config.ts#L9)
 
 ## Parameters
 

package/docs/api/functions/loadFileFromPaths.md

@@ -8,7 +8,7 @@
 
 > **loadFileFromPaths**(`filename`, `searchPaths?`, `extNames?`, `options?`): `Buffer`\<`ArrayBufferLike`\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/load-file-from-paths.ts:44](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/load-file-from-paths.ts#L44)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/load-file-from-paths.ts:44](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/load-file-from-paths.ts#L44)
 
 Loads a file from given paths, optionally searching for specific extensions.
 

package/docs/api/functions/loadTextFromPaths.md

@@ -8,7 +8,7 @@
 
 > **loadTextFromPaths**(`filename`, `searchPaths?`, `extNames?`, `options?`, `exclude?`): `string`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/load-file-from-paths.ts:101](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/load-file-from-paths.ts#L101)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/load-file-from-paths.ts:101](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/load-file-from-paths.ts#L101)
 
 ## Parameters
 

package/docs/api/functions/lrucache.md

@@ -8,7 +8,7 @@
 
 > **\_lrucache**(`this`, `__namedParameters`): `Cache`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/lrucache.ts:8](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/funcs/lrucache.ts#L8)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/lrucache.ts:8](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/funcs/lrucache.ts#L8)
 
 ## Parameters
 

package/docs/api/functions/matchUrlProtocol.md

@@ -6,9 +6,9 @@
 
 # Function: matchUrlProtocol()
 
-> **matchUrlProtocol**(`name`): `undefined` \| `string`
+> **matchUrlProtocol**(`name`): `string` \| `undefined`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/match-url-protocol.ts:23](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/match-url-protocol.ts#L23)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/match-url-protocol.ts:23](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/match-url-protocol.ts#L23)
 
 Extracts the protocol part from a URL-like string.
 
@@ -26,7 +26,7 @@ The string to inspect, expected to contain a URL.
 
 ## Returns
 
-`undefined` \| `string`
+`string` \| `undefined`
 
 - The protocol part if '://' is found; otherwise, undefined.
 

package/docs/api/functions/memoize.md

@@ -8,7 +8,7 @@
 
 > **memoize**\<`F`\>(`fn`, `options?`): `F` & `Memoized`\<`F`\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/memoize.ts:14](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/memoize.ts#L14)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/memoize.ts:14](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/memoize.ts#L14)
 
 ## Type Parameters
 

package/docs/api/functions/mergeArray.md

@@ -8,7 +8,7 @@
 
 > **mergeArray**(`targetArr`, `srcArr`): `any`[]
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/merge-with-concat.ts:100](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/merge-with-concat.ts#L100)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/merge-with-concat.ts:100](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/merge-with-concat.ts#L100)
 
 Merges two arrays based on a custom strategy defined by the first element of the target array.
 

package/docs/api/functions/messagesToText.md

@@ -8,7 +8,7 @@
 
 > **messagesToText**(`messages`): `string`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/chat.ts:158](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/chat.ts#L158)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/chat.ts:175](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/chat.ts#L175)
 
 ## Parameters
 

package/docs/api/functions/normalizePath.md

@@ -8,7 +8,7 @@
 
 > **normalizePath**(`inputPath`): `string`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/has-directory-in.ts:146](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/has-directory-in.ts#L146)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/has-directory-in.ts:146](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/has-directory-in.ts#L146)
 
 ## Parameters
 

package/docs/api/functions/paramsSizeToScaleStr.md

@@ -8,7 +8,7 @@
 
 > **paramsSizeToScaleStr**(`paramsSize`, `fractionDigits`): `string`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/convert-params-size.ts:11](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/convert-params-size.ts#L11)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/convert-params-size.ts:11](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/convert-params-size.ts#L11)
 
 Formats a parameter size in bytes into a string with an appropriate scale (T, B, M, or K),
 optionally specifying the number of fractional digits to display.

package/docs/api/functions/parseCommand.md

@@ -6,9 +6,11 @@
 
 # Function: parseCommand()
 
-> **parseCommand**(`commandStr`, `scope?`, `options?`): `Promise`\<`undefined` \| \{ `args?`: `Record`\<`string`, `any`\>; `command`: `string`; \}\>
+> **parseCommand**(`commandStr`, `scope?`, `options?`): `Promise`\<[`CmdArgParsedCommand`](../interfaces/CmdArgParsedCommand.md) \| `undefined`\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/parse-command.ts:446](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/parse-command.ts#L446)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/api.ts:267](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/api.ts#L267)
+
+Parses a full command string including the command name and its parenthesized arguments.
 
 ## Parameters
 
@@ -16,14 +18,29 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/parse-command.ts:446](htt
 
 `string`
 
+The command string, e.g., 'myCmd(arg1, k=v, !flag)'
+
 ### scope?
 
 `Record`\<`string`, `any`\>
 
+Evaluation scope.
+
 ### options?
 
-[`ParseObjectArgumentOptions`](../interfaces/ParseObjectArgumentOptions.md)
+[`CmdArgParserOptions`](../interfaces/CmdArgParserOptions.md)
+
+CmdArgParser configuration options.
 
 ## Returns
 
-`Promise`\<`undefined` \| \{ `args?`: `Record`\<`string`, `any`\>; `command`: `string`; \}\>
+`Promise`\<[`CmdArgParsedCommand`](../interfaces/CmdArgParsedCommand.md) \| `undefined`\>
+
+An object containing the command name, parsed args, and optional flags.
+
+## Example
+
+```ts
+await parseCommand("sum(1, 2)") // returns {command: "sum", args: [1, 2]}
+await parseCommand("search(query='abc', !caseSensitive)") // returns {command: "search", args: {query: 'abc'}, flags: {caseSensitive: true}}
+```

package/docs/api/functions/parseJsJson.md

@@ -8,7 +8,7 @@
 
 > **parseJsJson**(`input`, `scope?`): `Promise`\<`any`\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/parse-js-json.ts:16](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/parse-js-json.ts#L16)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/parse-js-json.ts:16](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/parse-js-json.ts#L16)
 
 Parses a JavaScript string into a JSON object.
 

package/docs/api/functions/parseJsJsonSimpleSync.md

@@ -8,7 +8,7 @@
 
 > **parseJsJsonSimpleSync**(`input`, `scope?`): `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/parse-js-json.ts:28](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/parse-js-json.ts#L28)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/parse-js-json.ts:28](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/parse-js-json.ts#L28)
 
 ## Parameters
 

package/docs/api/functions/parseObjectArguments.md

@@ -8,9 +8,10 @@
 
 > **parseObjectArguments**(`argsStr`, `scope?`, `options?`): `Promise`\<`any`\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/parse-command.ts:71](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/parse-command.ts#L71)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/api.ts:29](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/api.ts#L29)
 
-Asynchronously parses a string of object arguments into an actual object.
+Parses an object-style argument string into a structured result.
+Supports positional args, named args, JS expressions, and custom processors.
 
 ## Parameters
 
@@ -18,55 +19,38 @@ Asynchronously parses a string of object arguments into an actual object.
 
 `string`
 
-The string of arguments to be parsed.
+The argument string to parse.
 
 ### scope?
 
 `Record`\<`string`, `any`\>
 
-An optional scope object that provides values for variables during parsing.
+Optional evaluation scope for resolving variables.
 
 ### options?
 
-[`ParseObjectArgumentOptions`](../interfaces/ParseObjectArgumentOptions.md)
+[`CmdArgParserOptions`](../interfaces/CmdArgParserOptions.md)
 
-An optional configuration object containing the delimiter and argument processor.
+CmdArgParser configuration options.
 
 ## Returns
 
 `Promise`\<`any`\>
 
-The parsed object or undefined.
-
-This function first parses the argument string into an object string and then converts it
-into a proper JavaScript/JSON object based on the parsing results and configuration options.
-It handles the conversion of single objects, arrays, and key-value pairs. The default delimiter
-between parameters is a comma (`,`), but this can be customized using the `options.delimiter`.
-Parameter assignment always uses an equal sign (`=`) and cannot be modified.
-
-The function returns:
-- An object if the input string represents a set of key-value pairs.
-- An array if the input string represents a sequence of elements, where each element can be
-  parsed as a number (indices are used as keys).
-- A single value if the input string represents a single value or a single key-value pair.
-- `undefined` if the input string is empty or cannot be parsed into a valid object.
+The parsed and simplified result.
 
 ## Example
 
-```typescript
-// Example call with default delimiter
-const result = await parseObjectArguments("name=John,age=30");
-console.log(result); // Output: { name: 'John', age: '30' }
+```ts
+// 1. Simple positional
+await parseObjectArguments("123") // returns 123
 
-// Example call with custom delimiter
-const resultCustomDelimiter = await parseObjectArguments("name=John|age=30", undefined, { delimiter: '|' });
-console.log(resultCustomDelimiter); // Output: { name: 'John', age: '30' }
+// 2. Multiple positional
+await parseObjectArguments("1, 2, 3") // returns [1, 2, 3]
 
-// Example with a single value
-const singleValue = await parseObjectArguments("42");
-console.log(singleValue); // Output: 42
+// 3. Named arguments
+await parseObjectArguments("name='John', age=25") // returns {name: 'John', age: 25}
 
-// Example with an array
-const arrayResult = await parseObjectArguments("1,2,3");
-console.log(arrayResult); // Output: [1, 2, 3]
+// 4. Mixed (idAsName enabled by default)
+await parseObjectArguments("John, age=25") // returns {0: 'John', John: 'John', age: 25}
 ```

package/docs/api/functions/parseYaml.md

@@ -8,7 +8,7 @@
 
 > **parseYaml**(`content`, `options?`): `any`
 
-Defined in: @isdk/util/dist/index.d.ts:298
+Defined in: @isdk/util/dist/index.d.ts:299
 
 Parses a YAML string into a JavaScript object with optional custom tags.
 

package/docs/api/functions/prependNewlineIfMultiline.md

@@ -0,0 +1,39 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / prependNewlineIfMultiline
+
+# Function: prependNewlineIfMultiline()
+
+> **prependNewlineIfMultiline**(`text`): `string`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/prependNewlineIfMultiline.ts:18](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/prependNewlineIfMultiline.ts#L18)
+
+Prepends a newline character to the beginning of the input text if it is multiline and does not already start with a newline.
+
+This function checks whether the provided text contains multiple lines by looking for newline characters (`\n`).
+If the text is determined to be multiline and its first non-whitespace character is not a newline,
+a newline character will be added at the beginning of the text.
+
+## Parameters
+
+### text
+
+`string`
+
+The input string to check and potentially modify.
+
+## Returns
+
+`string`
+
+The processed string, which may have a prepended newline if conditions are met.
+
+## Example
+
+```typescript
+console.log(prependNewlineIfMultiline("  hello\nworld")); // Output: "\n  hello\nworld"
+console.log(prependNewlineIfMultiline("\nhello\nworld")); // Output: "\nhello\nworld" (unchanged)
+console.log(prependNewlineIfMultiline("single line")); // Output: "single line" (unchanged)
+```

package/docs/api/functions/pruneSubdirectories.md

@@ -8,7 +8,7 @@
 
 > **pruneSubdirectories**(`paths`): `string`[]
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/has-directory-in.ts:70](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/has-directory-in.ts#L70)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/has-directory-in.ts:70](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/has-directory-in.ts#L70)
 
 Filters out subdirectories from the given array of paths, keeping only the top-level (parent) directories.
 

package/docs/api/functions/pruneSubdirectoriesInPlace.md

@@ -8,7 +8,7 @@
 
 > **pruneSubdirectoriesInPlace**(`paths`): `void`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/has-directory-in.ts:93](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/has-directory-in.ts#L93)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/has-directory-in.ts:93](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/has-directory-in.ts#L93)
 
 Filters out subdirectories from the given array of paths in-place, keeping only the top-level (parent) directories.
 

package/docs/api/functions/quoteStr.md

@@ -8,7 +8,10 @@
 
 > **quoteStr**(`str`): `string`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/parse-command.ts:252](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/parse-command.ts#L252)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/utils.ts:115](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/utils.ts#L115)
+
+Escapes and wraps a string in double quotes.
+Avoids redundant escaping.
 
 ## Parameters
 

package/docs/api/functions/readFilenamesRecursiveSync.md

@@ -8,7 +8,7 @@
 
 > **readFilenamesRecursiveSync**(`dir`, `options?`): `string`[]
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/load-file-from-paths.ts:137](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/load-file-from-paths.ts#L137)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/load-file-from-paths.ts:137](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/load-file-from-paths.ts#L137)
 
 Recursively reads all filenames in the given directory or directories.
 Optionally filters the results using a file matching callback.

package/docs/api/functions/readTextFileChunks.md

@@ -8,7 +8,7 @@
 
 > **readTextFileChunks**(`filePath`, `options?`): `AsyncIterable`\<`string`\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/read-text-file-chunks.ts:41](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/read-text-file-chunks.ts#L41)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/read-text-file-chunks.ts:41](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/read-text-file-chunks.ts#L41)
 
 Reads a text file and yields chunks of text that are within a specified token limit.
 This function supports both small files that can be read entirely into memory,

package/docs/api/functions/readTextFileChunksEx.md

@@ -8,7 +8,7 @@
 
 > **readTextFileChunksEx**(`filePath`, `options?`): `AsyncIterable`\<`string`[]\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/read-text-file-chunks.ts:109](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/read-text-file-chunks.ts#L109)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/read-text-file-chunks.ts:109](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/read-text-file-chunks.ts#L109)
 
 ## Parameters
 

package/docs/api/functions/readableFromAsyncIterable.md

@@ -8,7 +8,7 @@
 
 > **readableFromAsyncIterable**\<`T`\>(`iterable`): `ReadableStream`\<`T`\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/stream/ai-stream.ts:164](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/stream/ai-stream.ts#L164)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/stream/ai-stream.ts:164](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/stream/ai-stream.ts#L164)
 
 Implements ReadableStream.from(asyncIterable), which isn't documented in MDN and isn't implemented in node.
 https://github.com/whatwg/streams/commit/8d7a0bf26eb2cc23e884ddbaac7c1da4b91cf2bc

package/docs/api/functions/registerCoreTools.md

@@ -8,7 +8,7 @@
 
 > **registerCoreTools**(): `void`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/index.ts:9](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/funcs/index.ts#L9)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/index.ts:7](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/funcs/index.ts#L7)
 
 ## Returns
 

package/docs/api/functions/registerYamlTag.md

@@ -8,7 +8,7 @@
 
 > **registerYamlTag**(`tags`): `void`
 
-Defined in: @isdk/util/dist/index.d.ts:279
+Defined in: @isdk/util/dist/index.d.ts:280
 
 Registers custom YAML tags to be used in parsing and stringifying YAML content.
 
@@ -18,7 +18,7 @@ Registers custom YAML tags to be used in parsing and stringifying YAML content.
 
 A single tag or an array of tags to register.
 
-`"map"` | `"binary"` | `"null"` | `ScalarTag` | `CollectionTag` | `"bool"` | `"float"` | `"floatExp"` | `"floatNaN"` | `"floatTime"` | `"int"` | `"intHex"` | `"intOct"` | `"intTime"` | `"merge"` | `"omap"` | `"pairs"` | `"seq"` | `"set"` | `"timestamp"` | `Tags`
+`"map"` | `"null"` | `"binary"` | `ScalarTag` | `CollectionTag` | `"bool"` | `"float"` | `"floatExp"` | `"floatNaN"` | `"floatTime"` | `"int"` | `"intHex"` | `"intOct"` | `"intTime"` | `"merge"` | `"omap"` | `"pairs"` | `"seq"` | `"set"` | `"timestamp"` | `Tags`
 
 ## Returns
 

package/docs/api/functions/removeMarkdownBold.md

@@ -8,7 +8,7 @@
 
 > **removeMarkdownBold**(`s`, `once?`): `string`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/split-sentence.ts:292](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/split-sentence.ts#L292)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/split-sentence.ts:292](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/split-sentence.ts#L292)
 
 ## Parameters
 

package/docs/api/functions/removeMarkdownBoldAndItalic.md

@@ -8,7 +8,7 @@
 
 > **removeMarkdownBoldAndItalic**(`s`, `once?`): `string`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/split-sentence.ts:312](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/split-sentence.ts#L312)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/split-sentence.ts:312](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/split-sentence.ts#L312)
 
 ## Parameters
 

package/docs/api/functions/removeMarkdownItalic.md

@@ -8,7 +8,7 @@
 
 > **removeMarkdownItalic**(`s`, `once?`): `string`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/split-sentence.ts:302](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/split-sentence.ts#L302)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/split-sentence.ts:302](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/split-sentence.ts#L302)
 
 ## Parameters
 

package/docs/api/functions/replaceWithPlaceholder.md

@@ -8,9 +8,10 @@
 
 > **replaceWithPlaceholder**(`content`, `options?`): \[`string`, `string`[]\]
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/parse-command.ts:487](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/parse-command.ts#L487)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/utils.ts:124](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/utils.ts#L124)
 
-Replaces substrings in the given content with placeholders.
+Replaces specific wrapped substrings within a string with placeholders.
+Useful for processing strings while ignoring quoted or bracketed content.
 
 ## Parameters
 
@@ -18,26 +19,10 @@ Replaces substrings in the given content with placeholders.
 
 `string`
 
-The string content to process.
-
 ### options?
 
 [`ReplacePlacehoderOptions`](../interfaces/ReplacePlacehoderOptions.md)
 
-Optional configuration object with the following properties:
-  - `startChar` - The starting character(s) of the substrings to replace. Can be a single character or an array of characters. Defaults to `["\"", "'"]`.
-  - `endChar` - The ending character(s) of the substrings to replace. Can be a single character or an array of characters. Defaults to the value of `startChar`.
-  - `placeholder` - The prefix for the placeholder names. Defaults to `defaultPlaceholderName`.
-  - `placehoders` - An array of placeholders to use instead of generating new one.
-
 ## Returns
 
 \[`string`, `string`[]\]
-
-An array containing:
-  - `content` - The modified content with placeholders.
-  - `placehoders` - An array of the original substrings that were replaced.
-
-## Throws
-
-If the lengths of `startChar` and `endChar` are not the same.