@isdk/ai-tool 0.5.8 → 0.7.0

package/docs/{functions → api/functions}/backendEventable.md

@@ -8,7 +8,7 @@
 
 > **backendEventable**\<`T`\>(`targetClass`?, `options`?): `EnhancedClass`\<`T`, (`Backend`) => *typeof* `BackendEventable`\>
 
-Defined in: [packages/ai-tool/src/utils/event/event-ability.ts:82](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/event/event-ability.ts#L82)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/event/event-ability.ts:82](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/event/event-ability.ts#L82)
 
 ## Type Parameters
 

package/docs/{functions → api/functions}/beforeShutdown.md

@@ -8,7 +8,7 @@
 
 > **beforeShutdown**(`listener`): `undefined` \| [`BeforeShutdownListener`](../type-aliases/BeforeShutdownListener.md)
 
-Defined in: [packages/ai-tool/src/utils/node/before-shutdown.ts:95](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/node/before-shutdown.ts#L95)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/node/before-shutdown.ts:95](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/node/before-shutdown.ts#L95)
 
 Registers a new shutdown listener to be invoked before exiting
 the main process. Listener handlers are guaranteed to be called in the order

package/docs/api/functions/calcPerplexity.md

@@ -0,0 +1,60 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / calcPerplexity
+
+# Function: calcPerplexity()
+
+> **calcPerplexity**(`probabilities`, `options`?): `undefined` \| `number`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/calc-perplexity.ts:97](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/calc-perplexity.ts#L97)
+
+Calculates the perplexity of a given list of probability items.
+Perplexity is a measurement used in natural language processing (NLP)
+to evaluate the quality of a language model. Lower perplexity indicates
+better predictions made by the model.
+
+## Parameters
+
+### probabilities
+
+[`ProbabilityItem`](../interfaces/ProbabilityItem.md)[]
+
+An array of `ProbabilityItem` objects, each containing
+                       a token and its associated probability.
+
+### options?
+
+`CalcPerplexityOptions`
+
+Optional configuration for excluding specific types of tokens
+                 from the calculation.
+
+## Returns
+
+`undefined` \| `number`
+
+The calculated perplexity value as a number.
+
+## Example
+
+```typescript
+const probabilities = [
+  { token: "hello", probability: 0.1 },
+  { token: "world", probability: 0.05 },
+  { token: "<EOS>", probability: 0.02 },
+  { token: ",", probability: 0.01 }
+];
+
+// Exclude control symbols and punctuation from the calculation
+const options = {
+  exclude: {
+    controlSymbols: true,
+    punctuation: true
+  }
+};
+
+const perplexity = calcPerplexity(probabilities, options);
+console.log(perplexity); // Outputs the calculated perplexity value
+```

package/docs/api/functions/calcPerplexitySimple.md

@@ -0,0 +1,42 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / calcPerplexitySimple
+
+# Function: calcPerplexitySimple()
+
+> **calcPerplexitySimple**(`probabilities`): `undefined` \| `number`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/calc-perplexity.ts:126](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/calc-perplexity.ts#L126)
+
+A simplified version of the perplexity calculation function.
+This function directly calculates the perplexity from an array
+of `ProbabilityItem` objects without any token exclusion options.
+
+## Parameters
+
+### probabilities
+
+[`ProbabilityItem`](../interfaces/ProbabilityItem.md)[]
+
+An array of `ProbabilityItem` objects, each containing
+                       a token and its associated probability.
+
+## Returns
+
+`undefined` \| `number`
+
+The calculated perplexity value as a number.
+
+## Example
+
+```typescript
+const probabilities = [
+  { token: "hello", probability: 0.1 },
+  { token: "world", probability: 0.05 }
+];
+
+const perplexity = calcPerplexitySimple(probabilities);
+console.log(perplexity); // Outputs the calculated perplexity value
+```

package/docs/api/functions/canonicalize.md

@@ -0,0 +1,33 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / canonicalize
+
+# Function: canonicalize()
+
+> **canonicalize**(`obj`, `allowCircular`?): `string`
+
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/json-canonicalize@2.0.0/node\_modules/json-canonicalize/types/canonicalize.d.ts:8
+
+The main function for JSON canonicalization. It takes a JavaScript object and returns its canonical string representation.
+
+## Parameters
+
+### obj
+
+`any`
+
+The JavaScript object to canonicalize.
+
+### allowCircular?
+
+`boolean`
+
+If `true`, the function will handle circular references in the object by replacing them with `null`. Defaults to `false`.
+
+## Returns
+
+`string`
+
+The canonical string representation of the object.

package/docs/{functions → api/functions}/completeSentences.md

@@ -8,7 +8,7 @@
 
 > **completeSentences**(`sentences`, `__namedParameters`): `string`[]
 
-Defined in: [packages/ai-tool/src/utils/split-sentence.ts:123](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/split-sentence.ts#L123)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/split-sentence.ts:123](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/split-sentence.ts#L123)
 
 ## Parameters
 

package/docs/{functions → api/functions}/concatText.md

@@ -8,7 +8,7 @@
 
 > **concatText**(`left`, `right`): `string`
 
-Defined in: [packages/ai-tool/src/utils/split-sentence.ts:168](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/split-sentence.ts#L168)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/split-sentence.ts:168](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/split-sentence.ts#L168)
 
 ## Parameters
 

package/docs/{functions → api/functions}/countLLMTokens.md

@@ -8,7 +8,7 @@
 
 > **countLLMTokens**(`text`, `modelId`): `Promise`\<`number`\>
 
-Defined in: [packages/ai-tool/src/utils/llm-tokenizer.ts:74](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/llm-tokenizer.ts#L74)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/llm-tokenizer.ts:74](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/llm-tokenizer.ts#L74)
 
 ## Parameters
 

package/docs/{functions → api/functions}/countRegexMatches.md

@@ -8,7 +8,7 @@
 
 > **countRegexMatches**(`content`, `regex`): `number`
 
-Defined in: [packages/ai-tool/src/utils/count-regex-matches.ts:10](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/count-regex-matches.ts#L10)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/count-regex-matches.ts:10](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/count-regex-matches.ts#L10)
 
 Counts the number of matches for a given regular expression in a specified string.
 This function ensures that the regular expression is used globally by adding the 'g' flag,

package/docs/{functions → api/functions}/createAbilityInjector.md

@@ -10,7 +10,7 @@
 
 > **createAbilityInjector**\<`A`\>(`abilityClass`, `isGetClassFunc`?, `injectorOpts`?): `ClassAbilityFn`\<`A`\>
 
-Defined in: node\_modules/.pnpm/custom-ability@2.0.1/node\_modules/custom-ability/lib/custom-ability.d.ts:35
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-ability@2.0.1/node\_modules/custom-ability/lib/custom-ability.d.ts:35
 
 ### Type Parameters
 
@@ -38,7 +38,7 @@ Defined in: node\_modules/.pnpm/custom-ability@2.0.1/node\_modules/custom-abilit
 
 > **createAbilityInjector**\<`A`\>(`abilityClass`, `aCoreMethod`?, `isGetClassFunc`?, `injectorOpts`?): `ClassAbilityFn`\<`A`\>
 
-Defined in: node\_modules/.pnpm/custom-ability@2.0.1/node\_modules/custom-ability/lib/custom-ability.d.ts:36
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-ability@2.0.1/node\_modules/custom-ability/lib/custom-ability.d.ts:36
 
 ### Type Parameters
 
@@ -70,7 +70,7 @@ Defined in: node\_modules/.pnpm/custom-ability@2.0.1/node\_modules/custom-abilit
 
 > **createAbilityInjector**\<`A`\>(`abilityClass`, `aCoreMethod`?, `injectorOpts`?): `ClassAbilityFn`\<`A`\>
 
-Defined in: node\_modules/.pnpm/custom-ability@2.0.1/node\_modules/custom-ability/lib/custom-ability.d.ts:37
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-ability@2.0.1/node\_modules/custom-ability/lib/custom-ability.d.ts:37
 
 ### Type Parameters
 
@@ -98,7 +98,7 @@ Defined in: node\_modules/.pnpm/custom-ability@2.0.1/node\_modules/custom-abilit
 
 > **createAbilityInjector**\<`A`\>(`abilityClass`, `injectorOpts`?): `ClassAbilityFn`\<`A`\>
 
-Defined in: node\_modules/.pnpm/custom-ability@2.0.1/node\_modules/custom-ability/lib/custom-ability.d.ts:38
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-ability@2.0.1/node\_modules/custom-ability/lib/custom-ability.d.ts:38
 
 ### Type Parameters
 

package/docs/{functions → api/functions}/createCallbacksTransformer.md

@@ -8,7 +8,7 @@
 
 > **createCallbacksTransformer**\<`I`, `O`\>(`cb`): `TransformStream`\<`I`, `O`\>
 
-Defined in: [packages/ai-tool/src/utils/stream/create-callbacks-stream.ts:36](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/stream/create-callbacks-stream.ts#L36)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/stream/create-callbacks-stream.ts:36](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/stream/create-callbacks-stream.ts#L36)
 
 Creates a transform stream that invokes optional callback functions.
 The transform stream uses the provided callbacks to execute custom logic at different stages of the stream's lifecycle.

package/docs/{functions → api/functions}/createEmptyReadableStream.md

@@ -8,7 +8,7 @@
 
 > **createEmptyReadableStream**(): `ReadableStream`
 
-Defined in: [packages/ai-tool/src/utils/stream/create-empty-stream.ts:8](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/stream/create-empty-stream.ts#L8)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/stream/create-empty-stream.ts:8](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/stream/create-empty-stream.ts#L8)
 
 Creates an empty ReadableStream that immediately closes upon creation.
 This function is used as a fallback for creating a ReadableStream when the response body is null or undefined,

package/docs/{functions → api/functions}/createEndWithRepetitionDetector.md

@@ -8,7 +8,7 @@
 
 > **createEndWithRepetitionDetector**(`repetitionThreshold`): (`value`) => `null` \| `RegExpExecArray`
 
-Defined in: [packages/ai-tool/src/utils/end-with-repeated-sequence.ts:3](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/end-with-repeated-sequence.ts#L3)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/end-with-repeated-sequence.ts:3](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/end-with-repeated-sequence.ts#L3)
 
 ## Parameters
 

package/docs/{functions → api/functions}/createError.md

@@ -8,7 +8,7 @@
 
 > **createError**(`message`, `name`?, `status`?): [`CommonError`](../classes/CommonError.md)
 
-Defined in: node\_modules/.pnpm/@isdk+common-error@0.1.3/node\_modules/@isdk/common-error/dist/index.d.ts:153
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/@isdk+common-error@0.2.0/node\_modules/@isdk/common-error/dist/index.d.ts:164
 
 Create an error object
 

package/docs/{functions → api/functions}/createEventStreamTransformer.md

@@ -8,7 +8,7 @@
 
 > **createEventStreamTransformer**\<`TValue`, `TOptions`\>(`customParser`?): `TransformStream`\<`Uint8Array`\<`ArrayBufferLike`\>, [`AIResult`](../interfaces/AIResult.md)\<`TValue`, `TOptions`\>\>
 
-Defined in: [packages/ai-tool/src/utils/stream/ai-stream.ts:36](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/stream/ai-stream.ts#L36)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/stream/ai-stream.ts:36](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/stream/ai-stream.ts#L36)
 
 Creates a TransformStream that parses events from an EventSource stream using a custom parser.
 

package/docs/{functions → api/functions}/createHfValueFunc.md

@@ -8,7 +8,7 @@
 
 > **createHfValueFunc**(`fn`): (`_data`) => `Function`
 
-Defined in: [packages/ai-tool/src/utils/prompt/hf-prompt-template.ts:154](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/hf-prompt-template.ts#L154)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:610
 
 ## Parameters
 

package/docs/{functions → api/functions}/createLRUCache.md

@@ -8,7 +8,7 @@
 
 > **createLRUCache**(`name`, `options`?): [`ToolFunc`](../classes/ToolFunc.md)
 
-Defined in: [packages/ai-tool/src/funcs/lrucache.ts:24](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/funcs/lrucache.ts#L24)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/lrucache.ts:24](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/funcs/lrucache.ts#L24)
 
 ## Parameters
 

package/docs/{functions → api/functions}/createYamlObjectTag.md

@@ -8,7 +8,7 @@
 
 > **createYamlObjectTag**(`tag`, `BaseObject`): `any`
 
-Defined in: [packages/ai-tool/src/utils/yaml-type-base-object.ts:10](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/yaml-type-base-object.ts#L10)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/yaml-type-base-object.ts:10](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/yaml-type-base-object.ts#L10)
 
 ## Parameters
 

package/docs/{functions → api/functions}/dateToText.md

@@ -8,7 +8,7 @@
 
 > **dateToText**(`date`, `format`): `string`
 
-Defined in: [packages/ai-tool/src/utils/to-datetime.ts:29](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/to-datetime.ts#L29)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/to-datetime.ts:35](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/to-datetime.ts#L35)
 
 ## Parameters
 

package/docs/{functions → api/functions}/decodeCharset.md

@@ -8,7 +8,7 @@
 
 > **decodeCharset**(`result`, `encoding`?): `string`
 
-Defined in: [packages/ai-tool/src/utils/load-file-from-paths.ts:113](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/load-file-from-paths.ts#L113)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/load-file-from-paths.ts:113](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/load-file-from-paths.ts#L113)
 
 ## Parameters
 

package/docs/api/functions/defaultsWithConcat.md

@@ -0,0 +1,74 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / defaultsWithConcat
+
+# Function: defaultsWithConcat()
+
+> **defaultsWithConcat**(`target`, ...`source`): `any`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/merge-with-concat.ts:60](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/merge-with-concat.ts#L60)
+
+Merges multiple source objects into the target object with a custom merging strategy.
+
+## Parameters
+
+### target
+
+`any`
+
+The target object, whose properties will be overridden or merged by source object values.
+
+### source
+
+...`any`[]
+
+Source objects, whose properties will be merged into the target object.
+
+## Returns
+
+`any`
+
+The merged target object.
+
+This function performs deep merging using the following rules:
+- For non-array properties, standard deep merging is applied.
+- For arrays, a custom merging strategy is used based on the first element of the target array:
+  - **`@inheritMerge(.start)`** or no marker: Prepend the target array to the source array. defaults to this.
+  - **`@inheritMerge(.end)`**: Append the source array to the end of the target array.
+  - **`@inheritMerge(false)`**, **`@inheritMerge(no)`**, or **`@inheritMerge(not)`**: Replace the target array with the source array.
+
+## Example
+
+```typescript
+// Example 1: Default behavior (.start)
+const target = {
+  items: ['item1', 'item2']
+};
+const source = {
+  items: ['item3', 'item4']
+};
+console.log(defaultsWithConcat(target, source).items);
+// Output: ['item3', 'item4', 'item1', 'item2']
+
+// Example 2: Append behavior (.end)
+const target = {
+  items: ['@inheritMerge(.end)', 'item1', 'item2']
+};
+const source = {
+  items: ['item3', 'item4']
+};
+console.log(defaultsWithConcat(target, source).items);
+// Output: ['item1', 'item2', 'item3', 'item4']
+
+// Example 3: Replace behavior (false)
+const target = {
+  items: ['@inheritMerge(false)', 'item1', 'item2']
+};
+const source = {
+  items: ['item3', 'item4']
+};
+console.log(defaultsWithConcat(target, source).items);
+// Output: ['item3', 'item4']
+```

package/docs/{functions → api/functions}/detectCharset.md

@@ -8,7 +8,7 @@
 
 > **detectCharset**(`content`, `options`?): `string`
 
-Defined in: [packages/ai-tool/src/utils/load-file-from-paths.ts:248](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/load-file-from-paths.ts#L248)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/load-file-from-paths.ts:263](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/load-file-from-paths.ts#L263)
 
 ## Parameters
 

package/docs/{functions → api/functions}/encodeLLMTokens.md

@@ -8,7 +8,7 @@
 
 > **encodeLLMTokens**(`text`, `modelId`): `Promise`\<`number`[]\>
 
-Defined in: [packages/ai-tool/src/utils/llm-tokenizer.ts:68](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/llm-tokenizer.ts#L68)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/llm-tokenizer.ts:68](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/llm-tokenizer.ts#L68)
 
 ## Parameters
 

package/docs/{functions → api/functions}/ensureQuoted.md

@@ -8,7 +8,7 @@
 
 > **ensureQuoted**(`s`, `quoteChar`): `string`
 
-Defined in: [packages/ai-tool/src/utils/parse-command.ts:204](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/parse-command.ts#L204)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/parse-command.ts:204](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/parse-command.ts#L204)
 
 ## Parameters
 

package/docs/{functions → api/functions}/eventable.md

@@ -8,7 +8,7 @@
 
 > **eventable**\<`T`\>(`targetClass`?, `options`?): `T` & (`aClass`?) => `Function` & `T` *extends* (...`args`) => `any` ? `InstanceType`\<`T`\<`T`\>\> : `T`
 
-Defined in: node\_modules/.pnpm/events-ex@2.0.1/node\_modules/events-ex/lib/eventable.d.ts:48
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/events-ex@2.1.0/node\_modules/events-ex/lib/eventable.d.ts:48
 
 Adds event-emitting capabilities to a class by injecting necessary methods and properties.
 

package/docs/api/functions/expandConfig.md

@@ -0,0 +1,25 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / expandConfig
+
+# Function: expandConfig()
+
+> **expandConfig**(`config`, `defaultConfig`?): `any`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/load-config.ts:18](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/load-config.ts#L18)
+
+## Parameters
+
+### config
+
+`any`
+
+### defaultConfig?
+
+`any`
+
+## Returns
+
+`any`

package/docs/{functions → api/functions}/expandEnv.md

@@ -6,9 +6,9 @@
 
 # Function: expandEnv()
 
-> **expandEnv**(`options`): [`DotenvExpandOptions`](../interfaces/DotenvExpandOptions.md)
+> **expandEnv**(`options`): `DotenvExpandOptions`
 
-Defined in: [packages/ai-tool/src/utils/prompt/template/env.ts:98](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/template/env.ts#L98)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:705
 
 Expand environment variables in the parsed object
 
@@ -16,11 +16,11 @@ Expand environment variables in the parsed object
 
 ### options
 
-[`DotenvExpandOptions`](../interfaces/DotenvExpandOptions.md)
+`DotenvExpandOptions`
 
 ## Returns
 
-[`DotenvExpandOptions`](../interfaces/DotenvExpandOptions.md)
+`DotenvExpandOptions`
 
 ## Example
 

package/docs/{functions → api/functions}/expandObjEnv.md

@@ -6,9 +6,9 @@
 
 # Function: expandObjEnv()
 
-> **expandObjEnv**(`obj`, `options`, `parsedObjs`?): `any`
+> **expandObjEnv**(`obj`, `options`?, `parsedObjs`?): `any`
 
-Defined in: [packages/ai-tool/src/utils/prompt/template/env.ts:158](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/template/env.ts#L158)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:732
 
 Expands environment variables in an object/array or string.
 
@@ -24,9 +24,9 @@ processes objects and arrays with environment variable references.
 The object/array or string to be processed. Can be any value, but
              primarily designed for objects, array and strings.
 
-### options
+### options?
 
-[`DotenvExpandOptions`](../interfaces/DotenvExpandOptions.md) = `{}`
+`DotenvExpandOptions`
 
 Configuration options:
   - processEnv: - An object to source environment variables from, defaults to `process.env`.

package/docs/{functions → api/functions}/expandPath.md

@@ -8,7 +8,7 @@
 
 > **expandPath**(`path`, `config`?): `any`
 
-Defined in: [packages/ai-tool/src/utils/load-config.ts:67](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/load-config.ts#L67)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/load-config.ts:69](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/load-config.ts#L69)
 
 ## Parameters
 

package/docs/api/functions/expandPathInObject.md

@@ -0,0 +1,29 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / expandPathInObject
+
+# Function: expandPathInObject()
+
+> **expandPathInObject**(`obj`, `pathKeys`, `config`?): `void`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/load-config.ts:82](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/load-config.ts#L82)
+
+## Parameters
+
+### obj
+
+`any`
+
+### pathKeys
+
+`string`[] = `...`
+
+### config?
+
+`any`
+
+## Returns
+
+`void`

package/docs/api/functions/expandPaths.md

@@ -0,0 +1,25 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / expandPaths
+
+# Function: expandPaths()
+
+> **expandPaths**(`paths`, `config`?): `any`[]
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/load-config.ts:77](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/load-config.ts#L77)
+
+## Parameters
+
+### paths
+
+`string`[]
+
+### config?
+
+`any`
+
+## Returns
+
+`any`[]

package/docs/{functions → api/functions}/extNameLevel.md

@@ -8,7 +8,7 @@
 
 > **extNameLevel**(`extName`): `number`
 
-Defined in: [packages/ai-tool/src/utils/filename.ts:209](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/filename.ts#L209)
+Defined in: @isdk/util/dist/index.d.ts:449
 
 Calculates the level of an extension name.
 

package/docs/{functions → api/functions}/fileIsExists.md

@@ -8,7 +8,7 @@
 
 > **fileIsExists**(`filepath`): `undefined` \| `boolean`
 
-Defined in: [packages/ai-tool/src/utils/load-file-from-paths.ts:23](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/load-file-from-paths.ts#L23)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/load-file-from-paths.ts:23](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/load-file-from-paths.ts#L23)
 
 Checks if a file (not a directory) exists at the specified path.
 

package/docs/{functions → api/functions}/filterValidFnScope.md

@@ -8,7 +8,7 @@
 
 > **filterValidFnScope**(`scope`?): `undefined` \| `Record`\<`string`, `any`\>
 
-Defined in: [packages/ai-tool/src/utils/parse-js-json.ts:58](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/parse-js-json.ts#L58)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/parse-js-json.ts:58](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/parse-js-json.ts#L58)
 
 ## Parameters
 

package/docs/{functions → api/functions}/findIndexNonEmptyFrom.md

@@ -8,7 +8,7 @@
 
 > **findIndexNonEmptyFrom**(`arr`, `start`): `number`
 
-Defined in: [packages/ai-tool/src/utils/split-sentence.ts:282](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/split-sentence.ts#L282)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/split-sentence.ts:282](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/utils/split-sentence.ts#L282)
 
 ## Parameters