@isdk/ai-tool 0.5.2 → 0.5.3

package/docs/functions/parseObjectArgumentInfos.md

@@ -0,0 +1,29 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / parseObjectArgumentInfos
+
+# Function: parseObjectArgumentInfos()
+
+> **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/79d5773fa454dc7789b1291b1ebd73e4c1b93154/src/utils/parse-command.ts#L138)
+
+## Parameters
+
+### args
+
+`ArgInfo`[]
+
+### scope?
+
+`Record`\<`string`, `any`\>
+
+### options?
+
+[`ParseObjectArgumentOptions`](../interfaces/ParseObjectArgumentOptions.md)
+
+## Returns
+
+`Promise`\<`any`\>

package/docs/functions/parseObjectArguments.md

@@ -0,0 +1,72 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / parseObjectArguments
+
+# Function: parseObjectArguments()
+
+> **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/79d5773fa454dc7789b1291b1ebd73e4c1b93154/src/utils/parse-command.ts#L71)
+
+Asynchronously parses a string of object arguments into an actual object.
+
+## Parameters
+
+### argsStr
+
+`string`
+
+The string of arguments to be parsed.
+
+### scope?
+
+`Record`\<`string`, `any`\>
+
+An optional scope object that provides values for variables during parsing.
+
+### options?
+
+[`ParseObjectArgumentOptions`](../interfaces/ParseObjectArgumentOptions.md)
+
+An optional configuration object containing the delimiter and argument processor.
+
+## 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.
+
+## Example
+
+```typescript
+// Example call with default delimiter
+const result = await parseObjectArguments("name=John,age=30");
+console.log(result); // Output: { name: 'John', age: '30' }
+
+// Example call with custom delimiter
+const resultCustomDelimiter = await parseObjectArguments("name=John|age=30", undefined, { delimiter: '|' });
+console.log(resultCustomDelimiter); // Output: { name: 'John', age: '30' }
+
+// Example with a single value
+const singleValue = await parseObjectArguments("42");
+console.log(singleValue); // Output: 42
+
+// Example with an array
+const arrayResult = await parseObjectArguments("1,2,3");
+console.log(arrayResult); // Output: [1, 2, 3]
+```

package/docs/functions/parseObjectArgumentsAsArgInfos.md

@@ -0,0 +1,46 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / parseObjectArgumentsAsArgInfos
+
+# Function: parseObjectArgumentsAsArgInfos()
+
+> **parseObjectArgumentsAsArgInfos**(`argsStr`, `scope`?, `options`?): `ArgInfo`[]
+
+Defined in: [packages/ai-tool/src/utils/parse-command.ts:353](https://github.com/isdk/ai-tool.js/blob/79d5773fa454dc7789b1291b1ebd73e4c1b93154/src/utils/parse-command.ts#L353)
+
+Parses an object arguments string into an array of ArgInfo.
+
+This function processes a parameter string and parses it according to specific rules, allowing for custom delimiters.
+It can handle quotes, escape characters, and expressions within brackets. The parsing is designed to interpret
+object literal strings from dynamic languages, such as JSON objects or similar custom formats.
+
+## Parameters
+
+### argsStr
+
+`string`
+
+The string containing the arguments to be parsed.
+
+### scope?
+
+`Record`\<`string`, `any`\>
+
+An optional scope object used for further processing of the parsed arguments. Default is undefined.
+
+### options?
+
+[`ParseObjectArgumentOptions`](../interfaces/ParseObjectArgumentOptions.md)
+
+Parsing options, including:
+  - delimiter: The character used to separate arguments. Default is ','.
+  - argProcessor: An optional instance of ArgProcessor used for further processing of the parsed arguments.
+
+## Returns
+
+`ArgInfo`[]
+
+An array of parsed argument information, where each item contains a boolean indicating whether the argument is named,
+         and the string representation of the argument.

package/docs/functions/parseYaml.md

@@ -0,0 +1,25 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / parseYaml
+
+# Function: parseYaml()
+
+> **parseYaml**(`content`, `options`?): `any`
+
+Defined in: [packages/ai-tool/src/utils/config.ts:26](https://github.com/isdk/ai-tool.js/blob/79d5773fa454dc7789b1291b1ebd73e4c1b93154/src/utils/config.ts#L26)
+
+## Parameters
+
+### content
+
+`string`
+
+### options?
+
+`ParseOptions` & `DocumentOptions` & `SchemaOptions` & `ToJSOptions`
+
+## Returns
+
+`any`

package/docs/functions/quoteStr.md

@@ -0,0 +1,21 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / quoteStr
+
+# Function: quoteStr()
+
+> **quoteStr**(`str`): `string`
+
+Defined in: [packages/ai-tool/src/utils/parse-command.ts:252](https://github.com/isdk/ai-tool.js/blob/79d5773fa454dc7789b1291b1ebd73e4c1b93154/src/utils/parse-command.ts#L252)
+
+## Parameters
+
+### str
+
+`string`
+
+## Returns
+
+`string`

package/docs/functions/reControlCharsRegex.md

@@ -0,0 +1,19 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / reControlCharsRegex
+
+# Function: reControlCharsRegex()
+
+> **reControlCharsRegex**(): `RegExp`
+
+Defined in: [packages/ai-tool/src/utils/filename.ts:50](https://github.com/isdk/ai-tool.js/blob/79d5773fa454dc7789b1291b1ebd73e4c1b93154/src/utils/filename.ts#L50)
+
+Returns a new regular expression instance for control characters in a filename with the 'g' flag.
+
+## Returns
+
+`RegExp`
+
+A compiled regular expression for control characters in a filename.

package/docs/functions/readFilenamesRecursiveSync.md

@@ -0,0 +1,53 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / readFilenamesRecursiveSync
+
+# Function: readFilenamesRecursiveSync()
+
+> **readFilenamesRecursiveSync**(`dir`, `options`?): `string`[]
+
+Defined in: [packages/ai-tool/src/utils/load-file-from-paths.ts:136](https://github.com/isdk/ai-tool.js/blob/79d5773fa454dc7789b1291b1ebd73e4c1b93154/src/utils/load-file-from-paths.ts#L136)
+
+Recursively reads all filenames in the given directory or directories.
+Optionally filters the results using a file matching callback.
+
+## Parameters
+
+### dir
+
+A single directory path or an array of directory paths to start the search from.
+
+`string` | `string`[]
+
+### options?
+
+#### isFileMatched?
+
+(`filepath`, `file`) => `boolean`
+
+An optional callback that determines whether a file should be included in the result.
+
+#### level?
+
+`number`
+
+#### signal?
+
+`AbortSignal`
+
+An optional signal to abort the operation.
+
+## Returns
+
+`string`[]
+
+An array of file paths that match the criteria.
+
+## Example
+
+```typescript
+const files = readFilenamesRecursiveSync('/path/to/directory', {isFileMatched: (filepath) => filepath.endsWith('.js')});
+console.log(files); // Outputs an array of JavaScript file paths.
+```

package/docs/functions/readTextFileChunks.md

@@ -0,0 +1,53 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / readTextFileChunks
+
+# Function: readTextFileChunks()
+
+> **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/79d5773fa454dc7789b1291b1ebd73e4c1b93154/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,
+and large files that require streaming.
+
+Note: The specified `size` must not be less than the token count of the longest sentence.
+If the `size` is less than the token count of the longest sentence, some sentences may not
+fit completely into a single chunk.
+Without completeSentence and corrected Only!
+
+## Parameters
+
+### filePath
+
+`string`
+
+The path to the text file to be read.
+
+### options?
+
+[`IReadTextFileChunksOptions`](../interfaces/IReadTextFileChunksOptions.md)
+
+optional Options for reading the file.
+
+## Returns
+
+`AsyncIterable`\<`string`\>
+
+## Example
+
+```typescript
+const filePath = 'path/to/file.txt';
+const options = {
+  size: 2048,
+  modelId: 'gpt-3.5',
+  metaInfo: { size: 10240 }
+};
+
+for await (const chunk of readTextFileChunks(filePath, options)) {
+  console.log('Chunk:', chunk);
+}
+```

package/docs/functions/readTextFileChunksEx.md

@@ -0,0 +1,25 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / readTextFileChunksEx
+
+# Function: readTextFileChunksEx()
+
+> **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/79d5773fa454dc7789b1291b1ebd73e4c1b93154/src/utils/read-text-file-chunks.ts#L109)
+
+## Parameters
+
+### filePath
+
+`string`
+
+### options?
+
+[`IReadTextFileChunksOptions`](../interfaces/IReadTextFileChunksOptions.md)
+
+## Returns
+
+`AsyncIterable`\<`string`[]\>

package/docs/functions/readableFromAsyncIterable.md

@@ -0,0 +1,28 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / readableFromAsyncIterable
+
+# Function: readableFromAsyncIterable()
+
+> **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/79d5773fa454dc7789b1291b1ebd73e4c1b93154/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
+
+## Type Parameters
+
+• **T**
+
+## Parameters
+
+### iterable
+
+`AsyncIterable`\<`T`\>
+
+## Returns
+
+`ReadableStream`\<`T`\>

package/docs/functions/registerCoreTools.md

@@ -0,0 +1,15 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / registerCoreTools
+
+# Function: registerCoreTools()
+
+> **registerCoreTools**(): `void`
+
+Defined in: [packages/ai-tool/src/funcs/index.ts:9](https://github.com/isdk/ai-tool.js/blob/79d5773fa454dc7789b1291b1ebd73e4c1b93154/src/funcs/index.ts#L9)
+
+## Returns
+
+`void`

package/docs/functions/registerYamlTag.md

@@ -0,0 +1,21 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / registerYamlTag
+
+# Function: registerYamlTag()
+
+> **registerYamlTag**(`tags`): `void`
+
+Defined in: [packages/ai-tool/src/utils/config.ts:16](https://github.com/isdk/ai-tool.js/blob/79d5773fa454dc7789b1291b1ebd73e4c1b93154/src/utils/config.ts#L16)
+
+## Parameters
+
+### tags
+
+`any`
+
+## Returns
+
+`void`

package/docs/functions/removeMarkdownBold.md

@@ -0,0 +1,25 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / removeMarkdownBold
+
+# Function: removeMarkdownBold()
+
+> **removeMarkdownBold**(`s`, `once`?): `string`
+
+Defined in: [packages/ai-tool/src/utils/split-sentence.ts:292](https://github.com/isdk/ai-tool.js/blob/79d5773fa454dc7789b1291b1ebd73e4c1b93154/src/utils/split-sentence.ts#L292)
+
+## Parameters
+
+### s
+
+`string`
+
+### once?
+
+`boolean`
+
+## Returns
+
+`string`

package/docs/functions/removeMarkdownBoldAndItalic.md

@@ -0,0 +1,25 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / removeMarkdownBoldAndItalic
+
+# Function: removeMarkdownBoldAndItalic()
+
+> **removeMarkdownBoldAndItalic**(`s`, `once`?): `string`
+
+Defined in: [packages/ai-tool/src/utils/split-sentence.ts:312](https://github.com/isdk/ai-tool.js/blob/79d5773fa454dc7789b1291b1ebd73e4c1b93154/src/utils/split-sentence.ts#L312)
+
+## Parameters
+
+### s
+
+`string`
+
+### once?
+
+`boolean`
+
+## Returns
+
+`string`

package/docs/functions/removeMarkdownItalic.md

@@ -0,0 +1,25 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / removeMarkdownItalic
+
+# Function: removeMarkdownItalic()
+
+> **removeMarkdownItalic**(`s`, `once`?): `string`
+
+Defined in: [packages/ai-tool/src/utils/split-sentence.ts:302](https://github.com/isdk/ai-tool.js/blob/79d5773fa454dc7789b1291b1ebd73e4c1b93154/src/utils/split-sentence.ts#L302)
+
+## Parameters
+
+### s
+
+`string`
+
+### once?
+
+`boolean`
+
+## Returns
+
+`string`

package/docs/functions/replaceWithPlaceholder.md

@@ -0,0 +1,43 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / replaceWithPlaceholder
+
+# Function: replaceWithPlaceholder()
+
+> **replaceWithPlaceholder**(`content`, `options`?): \[`string`, `string`[]\]
+
+Defined in: [packages/ai-tool/src/utils/parse-command.ts:487](https://github.com/isdk/ai-tool.js/blob/79d5773fa454dc7789b1291b1ebd73e4c1b93154/src/utils/parse-command.ts#L487)
+
+Replaces substrings in the given content with placeholders.
+
+## Parameters
+
+### content
+
+`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.

package/docs/functions/restoreFromPlacehoders.md

@@ -0,0 +1,49 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / restoreFromPlacehoders
+
+# Function: restoreFromPlacehoders()
+
+> **restoreFromPlacehoders**(`content`, `placehoders`, `options`?): `string`
+
+Defined in: [packages/ai-tool/src/utils/parse-command.ts:540](https://github.com/isdk/ai-tool.js/blob/79d5773fa454dc7789b1291b1ebd73e4c1b93154/src/utils/parse-command.ts#L540)
+
+Restores the original substrings from placeholders in the given content.
+
+## Parameters
+
+### content
+
+`string`
+
+The string content containing placeholders to be restored.
+
+### placehoders
+
+`string`[]
+
+An array of the original substrings that were replaced by placeholders.
+
+### options?
+
+[`ReplacePlacehoderOptions`](../interfaces/ReplacePlacehoderOptions.md)
+
+Optional configuration object with the following properties:
+  - `placeholder` - The prefix for the placeholder names. Defaults to `__PlacEhoLdeR_`.
+
+## Returns
+
+`string`
+
+The modified content with the original substrings restored.
+
+## Example
+
+```typescript
+const contentWithPlaceholders = "Hello __PlacEhoLdeR_0, welcome to __PlacEhoLdeR_1!";
+const originalSubstrings = ["World", "the site"];
+const restoredContent = restoreFromPlacehoders(contentWithPlaceholders, originalSubstrings);
+console.log(restoredContent); // Output: "Hello World, welcome to the site!"
+```

package/docs/functions/sanitizeFilename.md

@@ -0,0 +1,39 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / sanitizeFilename
+
+# Function: sanitizeFilename()
+
+> **sanitizeFilename**(`filename`, `options`): `string`
+
+Defined in: [packages/ai-tool/src/utils/filename.ts:97](https://github.com/isdk/ai-tool.js/blob/79d5773fa454dc7789b1291b1ebd73e4c1b93154/src/utils/filename.ts#L97)
+
+Sanitizes a given filename by replacing invalid characters with a specified replacement character or a default.
+
+## Parameters
+
+### filename
+
+`string`
+
+The filename to sanitize, represented as a string.
+
+### options
+
+[`SanitizeFilenameOptions`](../interfaces/SanitizeFilenameOptions.md) = `{}`
+
+An optional object containing configuration options:
+  - `replacement` {string} - The character to replace invalid characters with. Default is '!'. Cannot contain reserved filename characters.
+  - `maxLength` {number} - The maximum length of the sanitized filename. Default is `MAX_FILENAME_LENGTH`.
+
+## Returns
+
+`string`
+
+The sanitized filename.
+
+## Throws
+
+- If the `replacement` contains reserved filename characters or control characters.

package/docs/functions/sanitizeFilepath.md

@@ -0,0 +1,33 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / sanitizeFilepath
+
+# Function: sanitizeFilepath()
+
+> **sanitizeFilepath**(`filepath`, `options`): `string`
+
+Defined in: [packages/ai-tool/src/utils/filename.ts:149](https://github.com/isdk/ai-tool.js/blob/79d5773fa454dc7789b1291b1ebd73e4c1b93154/src/utils/filename.ts#L149)
+
+Sanitizes each part of a file path and reassembles it, ensuring the path is valid according to provided options.
+
+## Parameters
+
+### filepath
+
+`string`
+
+The file path to sanitize, represented as a string.
+
+### options
+
+[`SanitizeFilenameOptions`](../interfaces/SanitizeFilenameOptions.md) = `{}`
+
+Optional settings for sanitization, extending `SanitizeFilenameOptions`. Allows customization of replacement characters and maximum filename length.
+
+## Returns
+
+`string`
+
+The sanitized file path as a string.