npm - @isdk/ai-tool - Versions diffs - 0.6.0 → 0.7.0 - Mend

@isdk/ai-tool 0.6.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (467) hide show

package/docs/{functions → api/functions}/lrucache.md RENAMED Viewed

@@ -8,7 +8,7 @@
 > **\_lrucache**(`this`, `__namedParameters`): `Cache`
-Defined in: [packages/ai-tool/src/funcs/lrucache.ts:8](https://github.com/isdk/ai-tool.js/blob/b0ee9498dddfa5222989cf00502bb34c601df743/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/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/funcs/lrucache.ts#L8)
 ## Parameters

package/docs/{functions → api/functions}/makeToolFuncCancelable.md RENAMED Viewed

@@ -8,7 +8,7 @@
 > **makeToolFuncCancelable**\<`T`\>(`targetClass`?, `options`?): `EnhancedClass`\<`T`, *typeof* [`CancelableAbility`](../classes/CancelableAbility.md)\>
-Defined in: [packages/ai-tool/src/utils/cancelable-ability.ts:382](https://github.com/isdk/ai-tool.js/blob/b0ee9498dddfa5222989cf00502bb34c601df743/src/utils/cancelable-ability.ts#L382)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/cancelable-ability.ts:428](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/cancelable-ability.ts#L428)
 ## Type Parameters

package/docs/{functions → api/functions}/matchUrlProtocol.md RENAMED Viewed

@@ -8,7 +8,7 @@
 > **matchUrlProtocol**(`name`): `undefined` \| `string`
-Defined in: [packages/ai-tool/src/utils/match-url-protocol.ts:23](https://github.com/isdk/ai-tool.js/blob/b0ee9498dddfa5222989cf00502bb34c601df743/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/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/match-url-protocol.ts#L23)
 Extracts the protocol part from a URL-like string.

package/docs/{functions → api/functions}/memoize.md RENAMED Viewed

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

package/docs/api/functions/mergeArray.md ADDED Viewed

@@ -0,0 +1,57 @@
+[**@isdk/ai-tool**](../README.md)
+***
+[@isdk/ai-tool](../globals.md) / mergeArray
+# Function: mergeArray()
+> **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/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/merge-with-concat.ts#L100)
+Merges two arrays based on a custom strategy defined by the first element of the target array.
+The first element of the target array can contain a special marker (`@inheritMerge`) to control the merging behavior:
+- `@inheritMerge(false)` or `@inheritMerge(no)` or `@inheritMerge(not)`: Replace the target array with the source array.
+- `@inheritMerge(.end)`: Append the source array to the end of the target array.
+- `@inheritMerge(.start)` or no marker: Prepend the target array to the source array.
+## Parameters
+### targetArr
+`any`[]
+The target array to be merged.
+### srcArr
+`any`[]
+The source array to merge into the target array.
+## Returns
+`any`[]
+The merged array based on the specified strategy.
+## Example
+```typescript
+// Example 1: Default behavior (.start)
+const target = ['item1', 'item2'];
+const source = ['item3', 'item4'];
+console.log(mergeArray(target, source)); // Output: ['item3', 'item4', 'item1', 'item2']
+// Example 2: Append behavior (.end)
+const target = ['@inheritMerge(.end)', 'item1', 'item2'];
+const source = ['item3', 'item4'];
+console.log(mergeArray(target, source)); // Output: ['item1', 'item2', 'item3', 'item4']
+// Example 3: Replace behavior (false)
+const target = ['@inheritMerge(false)', 'item1', 'item2'];
+const source = ['item3', 'item4'];
+console.log(mergeArray(target, source)); // Output: ['item3', 'item4']
+```

package/docs/{functions → api/functions}/messagesToText.md RENAMED Viewed

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

package/docs/api/functions/normalizePath.md ADDED Viewed

@@ -0,0 +1,21 @@
+[**@isdk/ai-tool**](../README.md)
+***
+[@isdk/ai-tool](../globals.md) / normalizePath
+# Function: normalizePath()
+> **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/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/has-directory-in.ts#L146)
+## Parameters
+### inputPath
+`string`
+## Returns
+`string`

package/docs/{functions → api/functions}/paramsSizeToScaleStr.md RENAMED Viewed

@@ -8,7 +8,7 @@
 > **paramsSizeToScaleStr**(`paramsSize`, `fractionDigits`): `string`
-Defined in: [packages/ai-tool/src/utils/convert-params-size.ts:11](https://github.com/isdk/ai-tool.js/blob/b0ee9498dddfa5222989cf00502bb34c601df743/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/209a87173b5eabb2f81db6ea9a6784f34c24e271/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/{functions → api/functions}/parseCommand.md RENAMED Viewed

@@ -8,7 +8,7 @@
 > **parseCommand**(`commandStr`, `scope`?, `options`?): `Promise`\<`undefined` \| \{ `args`: `Record`\<`string`, `any`\>; `command`: `string`; \}\>
-Defined in: [packages/ai-tool/src/utils/parse-command.ts:446](https://github.com/isdk/ai-tool.js/blob/b0ee9498dddfa5222989cf00502bb34c601df743/src/utils/parse-command.ts#L446)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/parse-command.ts:446](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/parse-command.ts#L446)
 ## Parameters

package/docs/{functions → api/functions}/parseDateFormat.md RENAMED Viewed

@@ -8,7 +8,7 @@
 > **parseDateFormat**\<`DateType`, `ResultDate`\>(`dateStr`, `formatStr`, `referenceDate`, `options`?): `ResultDate`
-Defined in: node\_modules/.pnpm/date-fns@4.1.0/node\_modules/date-fns/parse.d.ts:319
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/date-fns@4.1.0/node\_modules/date-fns/parse.d.ts:319
 ## Type Parameters

package/docs/{functions → api/functions}/parseISO.md RENAMED Viewed

@@ -8,7 +8,7 @@
 > **parseISO**\<`DateType`, `ResultDate`\>(`argument`, `options`?): `ResultDate`
-Defined in: node\_modules/.pnpm/date-fns@4.1.0/node\_modules/date-fns/parseISO.d.ts:43
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/date-fns@4.1.0/node\_modules/date-fns/parseISO.d.ts:43
 ## Type Parameters

package/docs/{functions → api/functions}/parseJsJson.md RENAMED Viewed

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

package/docs/{functions → api/functions}/parseJsJsonSimpleSync.md RENAMED Viewed

@@ -8,7 +8,7 @@
 > **parseJsJsonSimpleSync**(`input`, `scope`?): `any`
-Defined in: [packages/ai-tool/src/utils/parse-js-json.ts:28](https://github.com/isdk/ai-tool.js/blob/b0ee9498dddfa5222989cf00502bb34c601df743/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/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/parse-js-json.ts#L28)
 ## Parameters

package/docs/{functions → api/functions}/parseObjectArgInfo.md RENAMED Viewed

@@ -8,7 +8,7 @@
 > **parseObjectArgInfo**(`argInfo`, `ix`, `scope`?, `options`?): `Promise`\<`string`\>
-Defined in: [packages/ai-tool/src/utils/parse-command.ts:304](https://github.com/isdk/ai-tool.js/blob/b0ee9498dddfa5222989cf00502bb34c601df743/src/utils/parse-command.ts#L304)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/parse-command.ts:304](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/parse-command.ts#L304)
 ## Parameters

package/docs/{functions → api/functions}/parseObjectArgumentInfos.md RENAMED Viewed

@@ -8,7 +8,7 @@
 > **parseObjectArgumentInfos**(`args`, `scope`?, `options`?): `Promise`\<`any`\>
-Defined in: [packages/ai-tool/src/utils/parse-command.ts:138](https://github.com/isdk/ai-tool.js/blob/b0ee9498dddfa5222989cf00502bb34c601df743/src/utils/parse-command.ts#L138)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/parse-command.ts:138](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/parse-command.ts#L138)
 ## Parameters

package/docs/{functions → api/functions}/parseObjectArguments.md RENAMED Viewed

@@ -8,7 +8,7 @@
 > **parseObjectArguments**(`argsStr`, `scope`?, `options`?): `Promise`\<`any`\>
-Defined in: [packages/ai-tool/src/utils/parse-command.ts:71](https://github.com/isdk/ai-tool.js/blob/b0ee9498dddfa5222989cf00502bb34c601df743/src/utils/parse-command.ts#L71)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/parse-command.ts:71](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/parse-command.ts#L71)
 Asynchronously parses a string of object arguments into an actual object.

package/docs/{functions → api/functions}/parseObjectArgumentsAsArgInfos.md RENAMED Viewed

@@ -8,7 +8,7 @@
 > **parseObjectArgumentsAsArgInfos**(`argsStr`, `scope`?, `options`?): `ArgInfo`[]
-Defined in: [packages/ai-tool/src/utils/parse-command.ts:353](https://github.com/isdk/ai-tool.js/blob/b0ee9498dddfa5222989cf00502bb34c601df743/src/utils/parse-command.ts#L353)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/parse-command.ts:353](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/parse-command.ts#L353)
 Parses an object arguments string into an array of ArgInfo.

package/docs/{functions → api/functions}/parseYaml.md RENAMED Viewed

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

package/docs/api/functions/pruneSubdirectories.md ADDED Viewed

@@ -0,0 +1,35 @@
+[**@isdk/ai-tool**](../README.md)
+***
+[@isdk/ai-tool](../globals.md) / pruneSubdirectories
+# Function: pruneSubdirectories()
+> **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/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/has-directory-in.ts#L70)
+Filters out subdirectories from the given array of paths, keeping only the top-level (parent) directories.
+## Parameters
+### paths
+`string`[]
+An array of directory paths.
+## Returns
+`string`[]
+A new array containing only the paths that are not subdirectories of any other path in the input.
+## Example
+```ts
+const paths = ['/usr/local', '/usr/local/include', '/home/user/project'];
+const result = pruneSubdirectories(paths);
+// result: ['/usr/local', '/home/user/project']
+```

package/docs/api/functions/pruneSubdirectoriesInPlace.md ADDED Viewed

@@ -0,0 +1,38 @@
+[**@isdk/ai-tool**](../README.md)
+***
+[@isdk/ai-tool](../globals.md) / pruneSubdirectoriesInPlace
+# Function: pruneSubdirectoriesInPlace()
+> **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/209a87173b5eabb2f81db6ea9a6784f34c24e271/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.
+This function helps organize file paths by:
+* Removing any subfolders that are completely contained within other folders
+* Preserving the original order of paths you added
+* Eliminating duplicate paths
+## Parameters
+### paths
+`string`[]
+Array of directory paths to clean (can mix different OS path formats)
+## Returns
+`void`
+## Example
+```ts
+let paths = ['/usr/local', '/usr/local/include', '/home/user/project'];
+pruneSubdirectoriesInPlace(paths);
+// paths is now: ['/usr/local', '/home/user/project']
+```

package/docs/{functions → api/functions}/quoteStr.md RENAMED Viewed

@@ -8,7 +8,7 @@
 > **quoteStr**(`str`): `string`
-Defined in: [packages/ai-tool/src/utils/parse-command.ts:252](https://github.com/isdk/ai-tool.js/blob/b0ee9498dddfa5222989cf00502bb34c601df743/src/utils/parse-command.ts#L252)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/parse-command.ts:252](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/parse-command.ts#L252)
 ## Parameters

package/docs/{functions → api/functions}/readFilenamesRecursiveSync.md RENAMED Viewed

@@ -8,7 +8,7 @@
 > **readFilenamesRecursiveSync**(`dir`, `options`?): `string`[]
-Defined in: [packages/ai-tool/src/utils/load-file-from-paths.ts:137](https://github.com/isdk/ai-tool.js/blob/b0ee9498dddfa5222989cf00502bb34c601df743/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/209a87173b5eabb2f81db6ea9a6784f34c24e271/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/{functions → api/functions}/readTextFileChunks.md RENAMED Viewed

@@ -8,7 +8,7 @@
 > **readTextFileChunks**(`filePath`, `options`?): `AsyncIterable`\<`string`\>
-Defined in: [packages/ai-tool/src/utils/read-text-file-chunks.ts:41](https://github.com/isdk/ai-tool.js/blob/b0ee9498dddfa5222989cf00502bb34c601df743/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/209a87173b5eabb2f81db6ea9a6784f34c24e271/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/{functions → api/functions}/readTextFileChunksEx.md RENAMED Viewed

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

package/docs/{functions → api/functions}/readableFromAsyncIterable.md RENAMED Viewed

@@ -8,7 +8,7 @@
 > **readableFromAsyncIterable**\<`T`\>(`iterable`): `ReadableStream`\<`T`\>
-Defined in: [packages/ai-tool/src/utils/stream/ai-stream.ts:164](https://github.com/isdk/ai-tool.js/blob/b0ee9498dddfa5222989cf00502bb34c601df743/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/209a87173b5eabb2f81db6ea9a6784f34c24e271/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/{functions → api/functions}/registerCoreTools.md RENAMED Viewed

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

package/docs/{functions → api/functions}/registerYamlTag.md RENAMED Viewed

@@ -8,7 +8,7 @@
 > **registerYamlTag**(`tags`): `void`
-Defined in: node\_modules/.pnpm/@isdk+util@0.3.0/node\_modules/@isdk/util/dist/index.d.ts:252
+Defined in: @isdk/util/dist/index.d.ts:279
 Registers custom YAML tags to be used in parsing and stringifying YAML content.

package/docs/{functions → api/functions}/removeMarkdownBold.md RENAMED Viewed

@@ -8,7 +8,7 @@
 > **removeMarkdownBold**(`s`, `once`?): `string`
-Defined in: [packages/ai-tool/src/utils/split-sentence.ts:292](https://github.com/isdk/ai-tool.js/blob/b0ee9498dddfa5222989cf00502bb34c601df743/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/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/split-sentence.ts#L292)
 ## Parameters

package/docs/{functions → api/functions}/removeMarkdownBoldAndItalic.md RENAMED Viewed

@@ -8,7 +8,7 @@
 > **removeMarkdownBoldAndItalic**(`s`, `once`?): `string`
-Defined in: [packages/ai-tool/src/utils/split-sentence.ts:312](https://github.com/isdk/ai-tool.js/blob/b0ee9498dddfa5222989cf00502bb34c601df743/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/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/split-sentence.ts#L312)
 ## Parameters

package/docs/{functions → api/functions}/removeMarkdownItalic.md RENAMED Viewed

@@ -8,7 +8,7 @@
 > **removeMarkdownItalic**(`s`, `once`?): `string`
-Defined in: [packages/ai-tool/src/utils/split-sentence.ts:302](https://github.com/isdk/ai-tool.js/blob/b0ee9498dddfa5222989cf00502bb34c601df743/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/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/split-sentence.ts#L302)
 ## Parameters

package/docs/{functions → api/functions}/replaceWithPlaceholder.md RENAMED Viewed

@@ -8,7 +8,7 @@
 > **replaceWithPlaceholder**(`content`, `options`?): \[`string`, `string`[]\]
-Defined in: [packages/ai-tool/src/utils/parse-command.ts:487](https://github.com/isdk/ai-tool.js/blob/b0ee9498dddfa5222989cf00502bb34c601df743/src/utils/parse-command.ts#L487)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/parse-command.ts:487](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/parse-command.ts#L487)
 Replaces substrings in the given content with placeholders.

package/docs/{functions → api/functions}/restoreFromPlacehoders.md RENAMED Viewed

@@ -8,7 +8,7 @@
 > **restoreFromPlacehoders**(`content`, `placehoders`, `options`?): `string`
-Defined in: [packages/ai-tool/src/utils/parse-command.ts:540](https://github.com/isdk/ai-tool.js/blob/b0ee9498dddfa5222989cf00502bb34c601df743/src/utils/parse-command.ts#L540)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/parse-command.ts:540](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/parse-command.ts#L540)
 Restores the original substrings from placeholders in the given content.

package/docs/{functions → api/functions}/sanitizeFilename.md RENAMED Viewed

@@ -8,7 +8,7 @@
 > **sanitizeFilename**(`filename`, `options`?): `string`
-Defined in: node\_modules/.pnpm/@isdk+util@0.3.0/node\_modules/@isdk/util/dist/index.d.ts:393
+Defined in: @isdk/util/dist/index.d.ts:420
 Sanitizes a given filename by replacing invalid characters with a specified replacement character or a default.

package/docs/{functions → api/functions}/sanitizeFilepath.md RENAMED Viewed

@@ -8,7 +8,7 @@
 > **sanitizeFilepath**(`filepath`, `options`?): `string`
-Defined in: node\_modules/.pnpm/@isdk+util@0.3.0/node\_modules/@isdk/util/dist/index.d.ts:400
+Defined in: @isdk/util/dist/index.d.ts:427
 Sanitizes each part of a file path and reassembles it, ensuring the path is valid according to provided options.

package/docs/{functions → api/functions}/saveConfigFile.md RENAMED Viewed

@@ -8,7 +8,7 @@
 > **saveConfigFile**(`filename`, `config`, `extLevel`): `string`
-Defined in: [packages/ai-tool/src/utils/config.ts:46](https://github.com/isdk/ai-tool.js/blob/b0ee9498dddfa5222989cf00502bb34c601df743/src/utils/config.ts#L46)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/config.ts:46](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/config.ts#L46)
 ## Parameters

package/docs/{functions → api/functions}/scaleStrToParamsSize.md RENAMED Viewed

@@ -8,7 +8,7 @@
 > **scaleStrToParamsSize**(`scale`): `number`
-Defined in: [packages/ai-tool/src/utils/convert-params-size.ts:44](https://github.com/isdk/ai-tool.js/blob/b0ee9498dddfa5222989cf00502bb34c601df743/src/utils/convert-params-size.ts#L44)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/convert-params-size.ts:44](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/convert-params-size.ts#L44)
 Converts a formatted parameters size string (with units T, B, M, or K) back to its byte value.

package/docs/{functions → api/functions}/shutdown.md RENAMED Viewed

@@ -8,7 +8,7 @@
 > **shutdown**(`signalOrEvent`, `exitCode`): `Promise`\<`undefined`\>
-Defined in: [packages/ai-tool/src/utils/node/before-shutdown.ts:64](https://github.com/isdk/ai-tool.js/blob/b0ee9498dddfa5222989cf00502bb34c601df743/src/utils/node/before-shutdown.ts#L64)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/node/before-shutdown.ts:64](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/node/before-shutdown.ts#L64)
 Main process shutdown handler. Will invoke every previously registered async shutdown listener
 in the queue and exit with a code of `0`. Any `Promise` rejections from any listener will

package/docs/{functions → api/functions}/simplifyObjectArguments.md RENAMED Viewed

@@ -8,7 +8,7 @@
 > **simplifyObjectArguments**(`args`): `any`
-Defined in: [packages/ai-tool/src/utils/parse-command.ts:121](https://github.com/isdk/ai-tool.js/blob/b0ee9498dddfa5222989cf00502bb34c601df743/src/utils/parse-command.ts#L121)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/parse-command.ts:121](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/parse-command.ts#L121)
 ## Parameters

package/docs/api/functions/sleep.md ADDED Viewed

@@ -0,0 +1,36 @@
+[**@isdk/ai-tool**](../README.md)
+***
+[@isdk/ai-tool](../globals.md) / sleep
+# Function: sleep()
+> **sleep**(`ms`): `Promise`\<`void`\>
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/wait.ts:12](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/wait.ts#L12)
+Suspends execution for a specified number of milliseconds
+## Parameters
+### ms
+`number`
+The number of milliseconds to pause execution
+## Returns
+`Promise`\<`void`\>
+## Example
+```ts
+await sleep(500); // Pause for half a second
+```
+## Remarks
+This implementation uses `setTimeout` under the hood and is more precise
+for longer durations than `setImmediate`-based approaches

package/docs/{functions → api/functions}/sortedValues.md RENAMED Viewed

@@ -8,7 +8,7 @@
 > **sortedValues**\<`T`\>(`values`): `T`[]
-Defined in: [packages/ai-tool/src/utils/prompt/few-shot-prompt-template.ts:4](https://github.com/isdk/ai-tool.js/blob/b0ee9498dddfa5222989cf00502bb34c601df743/src/utils/prompt/few-shot-prompt-template.ts#L4)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/prompt/few-shot-prompt-template.ts:4](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/prompt/few-shot-prompt-template.ts#L4)
 ## Type Parameters

package/docs/{functions → api/functions}/splitChunks.md RENAMED Viewed

@@ -8,7 +8,7 @@
 > **splitChunks**(`content`, `options`?): `Promise`\<`string`[][]\>
-Defined in: [packages/ai-tool/src/utils/read-text-file-chunks.ts:182](https://github.com/isdk/ai-tool.js/blob/b0ee9498dddfa5222989cf00502bb34c601df743/src/utils/read-text-file-chunks.ts#L182)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/read-text-file-chunks.ts:182](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/read-text-file-chunks.ts#L182)
 ## Parameters

package/docs/{functions → api/functions}/splitParagraph.md RENAMED Viewed

@@ -8,7 +8,7 @@
 > **splitParagraph**(`value`, `options`?): `string`[][]
-Defined in: [packages/ai-tool/src/utils/split-paragraph.ts:12](https://github.com/isdk/ai-tool.js/blob/b0ee9498dddfa5222989cf00502bb34c601df743/src/utils/split-paragraph.ts#L12)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/split-paragraph.ts:12](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/split-paragraph.ts#L12)
 Splits the input string into paragraphs based on empty lines and title lines.
 Each paragraph is represented as an array of strings, where each string is a line in the paragraph.

package/docs/{functions → api/functions}/splitSentence.md RENAMED Viewed

@@ -8,7 +8,7 @@
 > **splitSentence**(`text`, `best`): `string`[]
-Defined in: [packages/ai-tool/src/utils/split-sentence.ts:44](https://github.com/isdk/ai-tool.js/blob/b0ee9498dddfa5222989cf00502bb34c601df743/src/utils/split-sentence.ts#L44)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/split-sentence.ts:44](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/split-sentence.ts#L44)
 Splits a text into sentences.
 This function is used to split a text into separate sentences, based on punctuation marks such as '.', '?', or '!' and other rules.

package/docs/api/functions/splitWords.md ADDED Viewed

@@ -0,0 +1,42 @@
+[**@isdk/ai-tool**](../README.md)
+***
+[@isdk/ai-tool](../globals.md) / splitWords
+# Function: splitWords()
+> **splitWords**(`input`): `string`[]
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/split-words.ts:41](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/split-words.ts#L41)
+Splits a string into an array of words based on case changes, digit boundaries, and spaces.
+This function identifies word boundaries using the following rules:
+1. Between a lowercase letter followed by an uppercase letter (camelCase)
+2. Between a digit and a letter (alphanumeric boundaries)
+3. Between consecutive uppercase letters when followed by a lowercase letter (acronyms)
+4. At whitespace characters
+## Parameters
+### input
+`string`
+The string to be split into words
+## Returns
+`string`[]
+An array of words extracted from the input string
+## Example
+```ts
+splitWords("HelloWorld")     // Returns ["Hello", "World"]
+splitWords("item1label21Good") // Returns ["item1", "label21", "Good"]
+splitWords("HTTPRequest")    // Returns ["HTTP", "Request"]
+splitWords("Good morning")   // Returns ["Good", "morning"]
+```