@isdk/ai-tool 0.8.2 → 0.9.0

package/docs/api/functions/restoreFromPlacehoders.md

@@ -8,9 +8,9 @@
 
 > **restoreFromPlacehoders**(`content`, `placehoders`, `options?`): `string`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/parse-command.ts:540](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/parse-command.ts#L540)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/utils.ts:161](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/utils.ts#L161)
 
-Restores the original substrings from placeholders in the given content.
+Restores original string content from placeholders.
 
 ## Parameters
 
@@ -18,32 +18,14 @@ Restores the original substrings from placeholders in the given 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/api/functions/sanitizeFilename.md

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

package/docs/api/functions/sanitizeFilepath.md

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

package/docs/api/functions/saveConfigFile.md

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

package/docs/api/functions/scaleStrToParamsSize.md

@@ -8,7 +8,7 @@
 
 > **scaleStrToParamsSize**(`scale`): `number`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/convert-params-size.ts:44](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/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/d10fb4cda65fc1975152a2c3ab327ecab008dea1/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/api/functions/shutdown.md

@@ -8,7 +8,7 @@
 
 > **shutdown**(`signalOrEvent`, `exitCode`): `Promise`\<`undefined`\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/node/before-shutdown.ts:64](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/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/d10fb4cda65fc1975152a2c3ab327ecab008dea1/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
@@ -26,7 +26,7 @@ The exit signal or event name received on the process, defaults to shutdown.
 
 The optional exit code, defaults to 0.
 
-`null` | `string` | `number`
+`string` | `number` | `null`
 
 ## Returns
 

package/docs/api/functions/simplifyObjectArguments.md

@@ -8,7 +8,10 @@
 
 > **simplifyObjectArguments**(`args`): `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/parse-command.ts:121](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/parse-command.ts#L121)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/api.ts:170](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/api.ts#L170)
+
+Deeply simplifies object-style arguments (recursive convergence).
+Useful for normalizing complex argument structures.
 
 ## Parameters
 

package/docs/api/functions/simplifyResult.md

@@ -0,0 +1,34 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / simplifyResult
+
+# Function: simplifyResult()
+
+> **simplifyResult**(`result`, `options?`): `any`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/api.ts:68](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/api.ts#L68)
+
+Simplifies the raw parsing result into a more intuitive format.
+The behavior is controlled by `options.simplify`.
+
+## Parameters
+
+### result
+
+[`CmdArgParseResult`](../interfaces/CmdArgParseResult.md)
+
+The raw parse result.
+
+### options?
+
+[`CmdArgParserOptions`](../interfaces/CmdArgParserOptions.md)
+
+CmdArgParser configuration options.
+
+## Returns
+
+`any`
+
+A simplified value, array, or object.

package/docs/api/functions/sleep.md

@@ -8,7 +8,7 @@
 
 > **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/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/wait.ts#L12)
+Defined in: @isdk/util/dist/index.d.ts:603
 
 Suspends execution for a specified number of milliseconds
 

package/docs/api/functions/sortedValues.md

@@ -8,7 +8,7 @@
 
 > **sortedValues**\<`T`\>(`values`): `T`[]
 
-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/e883e341c67e937e7d3a3e95e8bc56844896f5a3/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/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/prompt/few-shot-prompt-template.ts#L4)
 
 ## Type Parameters
 

package/docs/api/functions/splitChunks.md

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

package/docs/api/functions/splitParagraph.md

@@ -8,7 +8,7 @@
 
 > **splitParagraph**(`value`, `options?`): `string`[][]
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/split-paragraph.ts:12](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/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/d10fb4cda65fc1975152a2c3ab327ecab008dea1/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/api/functions/splitSentence.md

@@ -8,7 +8,7 @@
 
 > **splitSentence**(`text`, `best`): `string`[]
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/split-sentence.ts:44](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/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/d10fb4cda65fc1975152a2c3ab327ecab008dea1/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

@@ -8,7 +8,7 @@
 
 > **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/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/split-words.ts#L41)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/split-words.ts:41](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/split-words.ts#L41)
 
 Splits a string into an array of words based on case changes, digit boundaries, and spaces.
 

package/docs/api/functions/stringifyYaml.md

@@ -8,7 +8,7 @@
 
 > **stringifyYaml**(`content`, `options?`): `string`
 
-Defined in: @isdk/util/dist/index.d.ts:317
+Defined in: @isdk/util/dist/index.d.ts:318
 
 Converts a JavaScript object into a YAML string with optional custom tags.
 

package/docs/api/functions/stripConsoleColor.md

@@ -8,7 +8,7 @@
 
 > **stripConsoleColor**(`str`): `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/strip-console-color.ts:1](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/strip-console-color.ts#L1)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/strip-console-color.ts:1](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/strip-console-color.ts#L1)
 
 ## Parameters
 

package/docs/api/functions/textToDate.md

@@ -8,7 +8,7 @@
 
 > **textToDate**(`date`, `format`): `Date`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/to-datetime.ts:31](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/to-datetime.ts#L31)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/to-datetime.ts:31](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/to-datetime.ts#L31)
 
 ## Parameters
 

package/docs/api/functions/textify.md

@@ -0,0 +1,43 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / textify
+
+# Function: textify()
+
+> **textify**(`data`, `options?`): `string`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/textify.ts:438](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/textify.ts#L438)
+
+将任意数据转换为易读的类 YAML 文本
+
+## Parameters
+
+### data
+
+`any`
+
+要转换的数据
+
+### options?
+
+[`TextifyOptions`](../interfaces/TextifyOptions.md)
+
+配置选项
+
+## Returns
+
+`string`
+
+格式化后的文本字符串
+
+## Example
+
+```ts
+const text = textify([{ name: 'Alice', age: 20 }, { name: 'Bob' }]);
+// 输出:
+// - name: Alice
+//   age: 20
+// - name: Bob
+```

package/docs/api/functions/toDateTime.md

@@ -6,9 +6,9 @@
 
 # Function: toDateTime()
 
-> **toDateTime**(`date`): `undefined` \| `Date`
+> **toDateTime**(`date`): `Date` \| `undefined`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/to-datetime.ts:15](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/to-datetime.ts#L15)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/to-datetime.ts:15](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/to-datetime.ts#L15)
 
 ## Parameters
 
@@ -18,4 +18,4 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/to-datetime.ts:15](https:
 
 ## Returns
 
-`undefined` \| `Date`
+`Date` \| `undefined`

package/docs/api/functions/toRegExp.md

@@ -8,7 +8,7 @@
 
 > **toRegExp**(`value`): `RegExp`
 
-Defined in: @isdk/ai-tools/node\_modules/.pnpm/util-ex@2.3.0/node\_modules/util-ex/lib/to-regexp.d.ts:9
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/util-ex@2.5.2/node\_modules/util-ex/lib/to-regexp.d.ts:9
 
 create or clone RegExp
 

package/docs/api/functions/trimStartOfStreamHelper.md

@@ -8,7 +8,7 @@
 
 > **trimStartOfStreamHelper**(): (`text`) => `string`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/stream/ai-stream.ts:90](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/stream/ai-stream.ts#L90)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/stream/ai-stream.ts:90](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/stream/ai-stream.ts#L90)
 
 Returns a stateful function that, when invoked, trims leading whitespace
 from the input text. The trimming only occurs on the first invocation, ensuring that

package/docs/api/functions/truncTo.md

@@ -8,7 +8,7 @@
 
 > **truncTo**(`n`, `dec`, `up`): `number`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/trunc-to.ts:19](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/trunc-to.ts#L19)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/trunc-to.ts:19](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/trunc-to.ts#L19)
 
 Truncates(Round) a number to a specified number of decimal places.
 

package/docs/api/functions/truncateByToken.md

@@ -8,7 +8,7 @@
 
 > **truncateByToken**(`content`, `options?`): `Promise`\<`void`\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/truncate-to-token-limit.ts:164](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/truncate-to-token-limit.ts#L164)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/truncate-to-token-limit.ts:164](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/truncate-to-token-limit.ts#L164)
 
 ## Parameters
 

package/docs/api/functions/truncateToTokenLimit.md

@@ -8,7 +8,7 @@
 
 > **truncateToTokenLimit**(`content`, `options?`): `Promise`\<`string`\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/truncate-to-token-limit.ts:31](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/truncate-to-token-limit.ts#L31)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/truncate-to-token-limit.ts:31](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/truncate-to-token-limit.ts#L31)
 
 Truncates the given content to fit within a specified token limit by removing sentences from the end.
 This function is suitable for text content with multiple sentences.

package/docs/api/functions/truncateToTokenLimitEx.md

@@ -8,7 +8,7 @@
 
 > **truncateToTokenLimitEx**(`sentences`, `options?`): `Promise`\<`string`[]\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/truncate-to-token-limit.ts:111](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/truncate-to-token-limit.ts#L111)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/truncate-to-token-limit.ts:111](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/truncate-to-token-limit.ts#L111)
 
 ## Parameters
 

package/docs/api/functions/uuid.md

@@ -8,7 +8,7 @@
 
 > **uuid**(`encode?`): `string`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/hash/uuid.ts:21](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/hash/uuid.ts#L21)
+Defined in: @isdk/ai-tools/packages/hash/dist/index.d.ts:32
 
 Generates a UUID (Universally Unique Identifier) based on the specified version and encoding options.
 

package/docs/api/functions/wrapEventEmitter.md

@@ -8,7 +8,7 @@
 
 > **wrapEventEmitter**(`o?`): `any`
 
-Defined in: @isdk/ai-tools/node\_modules/.pnpm/events-ex@2.1.0/node\_modules/events-ex/lib/wrap-event-emitter.d.ts:6
+Defined in: @isdk/util/node\_modules/.pnpm/events-ex@2.1.1/node\_modules/events-ex/lib/wrap-event-emitter.d.ts:6
 
 Create or inject the eventable instance into the object
 

package/docs/api/functions/wrapFlagValue.md

@@ -0,0 +1,29 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / wrapFlagValue
+
+# Function: wrapFlagValue()
+
+> **wrapFlagValue**(`value`, `prefix`): `any`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/utils.ts:49](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/utils.ts#L49)
+
+Wraps a value with a Flag Symbol.
+For primitive types (Boolean, String, Number), uses wrapper objects to support
+non-enumerable property attachment.
+
+## Parameters
+
+### value
+
+`any`
+
+### prefix
+
+`string`
+
+## Returns
+
+`any`

package/docs/api/functions/xxhash.md

@@ -6,9 +6,14 @@
 
 # Function: xxhash()
 
-> **xxhash**(`value`, `hashAlgo`, `seed`): `Uint8Array`
+> **xxhash**(`value`, `hashAlgo?`, `seed?`): `Uint8Array`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/hash/xxhash.ts:24](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/hash/xxhash.ts#L24)
+Defined in: @isdk/ai-tools/packages/hash/dist/index.d.ts:125
+
+Computes an XXHash (32-bit or 64-bit) for a given value and returns the result as a Uint8Array.
+
+This function provides a lower-level interface to XXHash, allowing for direct manipulation
+of the hash output as a byte array.
 
 ## Parameters
 
@@ -16,14 +21,30 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/hash/xxhash.ts:24](https:
 
 `HashValue`
 
-### hashAlgo
+The value to hash (string, ArrayBuffer, or Buffer).
+
+### hashAlgo?
+
+[`HashAlgorithm`](../enumerations/HashAlgorithm.md)
 
-[`HashAlgorithm`](../enumerations/HashAlgorithm.md) = `HashAlgorithm.xxhash64`
+The XXHash algorithm to use (xxhash32 or xxhash64).
 
-### seed
+### seed?
 
-`number` = `SEED`
+`number`
+
+The seed for the hashing algorithm.
 
 ## Returns
 
 `Uint8Array`
+
+The XXHash result as a Uint8Array.
+
+## Example
+
+```typescript
+const data = 'hello world';
+const hashBytes = xxhash(data, HashAlgorithm.xxhash64);
+console.log(hashBytes); // Uint8Array representation of the hash
+```

package/docs/api/functions/xxhash32.md

@@ -6,20 +6,38 @@
 
 # Function: xxhash32()
 
-> **xxhash32**(`value`, `radix`): `string`
+> **xxhash32**(`value`, `radix?`): `string`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/hash/xxhash.ts:8](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/hash/xxhash.ts#L8)
+Defined in: @isdk/ai-tools/packages/hash/dist/index.d.ts:82
+
+Computes a 32-bit XXHash for a given string or object.
+
+If the input is an object, it will be canonicalized to a JSON string before hashing.
+The result is returned as a hexadecimal string.
 
 ## Parameters
 
 ### value
 
+The string or object to hash.
+
 `string` | `object`
 
-### radix
+### radix?
+
+`number`
 
-`number` = `16`
+The radix for the output string (e.g., 16 for hexadecimal).
 
 ## Returns
 
 `string`
+
+The 32-bit XXHash as a string.
+
+## Example
+
+```typescript
+const hash1 = xxhash32('hello world'); // 'f2902a24'
+const hash2 = xxhash32({ a: 1, b: 2 }); // Consistent hash for objects
+```

package/docs/api/functions/xxhash64.md

@@ -6,20 +6,38 @@
 
 # Function: xxhash64()
 
-> **xxhash64**(`value`, `radix`): `string`
+> **xxhash64**(`value`, `radix?`): `string`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/hash/xxhash.ts:15](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/hash/xxhash.ts#L15)
+Defined in: @isdk/ai-tools/packages/hash/dist/index.d.ts:99
+
+Computes a 64-bit XXHash for a given string or object.
+
+If the input is an object, it will be canonicalized to a JSON string before hashing.
+The result is returned as a hexadecimal string.
 
 ## Parameters
 
 ### value
 
+The string or object to hash.
+
 `string` | `object`
 
-### radix
+### radix?
+
+`number`
 
-`number` = `16`
+The radix for the output string (e.g., 16 for hexadecimal).
 
 ## Returns
 
 `string`
+
+The 64-bit XXHash as a string.
+
+## Example
+
+```typescript
+const hash1 = xxhash64('hello world'); // '0b411719060a480a'
+const hash2 = xxhash64({ a: 1, b: 2 }); // Consistent hash for objects
+```

package/docs/api/functions/xxhashAsStr.md

@@ -6,24 +6,45 @@
 
 # Function: xxhashAsStr()
 
-> **xxhashAsStr**(`value`, `hashAlgo`, `seed`): `string`
+> **xxhashAsStr**(`value`, `hashAlgo?`, `seed?`): `string`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/hash/xxhash.ts:40](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/hash/xxhash.ts#L40)
+Defined in: @isdk/ai-tools/packages/hash/dist/index.d.ts:144
+
+Computes an XXHash for a given value and returns the result as a base32768 encoded string.
+
+This function is a convenience wrapper around `xxhash` that automatically encodes the
+resulting byte array into a compact, URL-friendly string.
 
 ## Parameters
 
 ### value
 
+The value to hash (string or Uint8Array).
+
 `string` | `Uint8Array`\<`ArrayBufferLike`\>
 
-### hashAlgo
+### hashAlgo?
+
+[`HashAlgorithm`](../enumerations/HashAlgorithm.md)
 
-[`HashAlgorithm`](../enumerations/HashAlgorithm.md) = `HashAlgorithm.xxhash64`
+The XXHash algorithm to use (xxhash32 or xxhash64).
 
-### seed
+### seed?
 
-`number` = `SEED`
+`number`
+
+The seed for the hashing algorithm.
 
 ## Returns
 
 `string`
+
+The XXHash result as a base32768 encoded string.
+
+## Example
+
+```typescript
+const data = 'hello world';
+const hashString = xxhashAsStr(data, HashAlgorithm.xxhash64);
+console.log(hashString); // Base32768 encoded string
+```

package/docs/api/functions/yieldExec.md

@@ -8,7 +8,7 @@
 
 > **yieldExec**(): `Promise`\<`void`\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/wait.ts:37](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/wait.ts#L37)
+Defined in: @isdk/util/dist/index.d.ts:616
 
 Yields execution control to the event loop, allowing pending I/O operations
 and scheduled tasks to run before continuing.