@isdk/ai-tool 0.8.2 → 0.9.0

package/docs/api/functions/assignDirs.md

@@ -8,7 +8,7 @@
 
 > **assignDirs**(`dest`, `src`): `string`[]
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/has-directory-in.ts:48](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/has-directory-in.ts#L48)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/has-directory-in.ts:48](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/has-directory-in.ts#L48)
 
 Assigns directories from the source array to the destination array if they do not already exist in the destination.
 

package/docs/api/functions/beforeShutdown.md

@@ -6,9 +6,9 @@
 
 # Function: beforeShutdown()
 
-> **beforeShutdown**(`listener`): `undefined` \| [`BeforeShutdownListener`](../type-aliases/BeforeShutdownListener.md)
+> **beforeShutdown**(`listener`): [`BeforeShutdownListener`](../type-aliases/BeforeShutdownListener.md) \| `undefined`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/node/before-shutdown.ts:95](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/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/d10fb4cda65fc1975152a2c3ab327ecab008dea1/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
@@ -24,6 +24,6 @@ The shutdown listener to register.
 
 ## Returns
 
-`undefined` \| [`BeforeShutdownListener`](../type-aliases/BeforeShutdownListener.md)
+[`BeforeShutdownListener`](../type-aliases/BeforeShutdownListener.md) \| `undefined`
 
 Echoes back the supplied `listener`.

package/docs/api/functions/calcPerplexity.md

@@ -6,9 +6,9 @@
 
 # Function: calcPerplexity()
 
-> **calcPerplexity**(`probabilities`, `options?`): `undefined` \| `number`
+> **calcPerplexity**(`probabilities`, `options?`): `number` \| `undefined`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/calc-perplexity.ts:97](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/calc-perplexity.ts#L97)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/calc-perplexity.ts:97](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/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)
@@ -33,7 +33,7 @@ Optional configuration for excluding specific types of tokens
 
 ## Returns
 
-`undefined` \| `number`
+`number` \| `undefined`
 
 The calculated perplexity value as a number.
 

package/docs/api/functions/calcPerplexitySimple.md

@@ -6,9 +6,9 @@
 
 # Function: calcPerplexitySimple()
 
-> **calcPerplexitySimple**(`probabilities`): `undefined` \| `number`
+> **calcPerplexitySimple**(`probabilities`): `number` \| `undefined`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/calc-perplexity.ts:126](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/calc-perplexity.ts#L126)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/calc-perplexity.ts:126](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/calc-perplexity.ts#L126)
 
 A simplified version of the perplexity calculation function.
 This function directly calculates the perplexity from an array
@@ -25,7 +25,7 @@ An array of `ProbabilityItem` objects, each containing
 
 ## Returns
 
-`undefined` \| `number`
+`number` \| `undefined`
 
 The calculated perplexity value as a number.
 

package/docs/api/functions/cmdArgEvaluate.md

@@ -0,0 +1,28 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / cmdArgEvaluate
+
+# Function: cmdArgEvaluate()
+
+> **cmdArgEvaluate**(`ctx`): `Promise`\<`any`\>
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/evaluator.ts:15](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/evaluator.ts#L15)
+
+Evaluates the value of an argument.
+
+Priority:
+1. Attempt to call a custom processor (ArgProcessor).
+2. If the processor returns a source string, recursively call evaluateExpression.
+3. Default to evaluateExpression (handles literals, scope variables, and JS expressions).
+
+## Parameters
+
+### ctx
+
+[`CmdArgContext`](../interfaces/CmdArgContext.md)
+
+## Returns
+
+`Promise`\<`any`\>

package/docs/api/functions/cmdArgsToMergedObject.md

@@ -0,0 +1,34 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / cmdArgsToMergedObject
+
+# Function: cmdArgsToMergedObject()
+
+> **cmdArgsToMergedObject**(`result`, `options?`): `Record`\<`string` \| `number`, `any`\>
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/api.ts:47](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/api.ts#L47)
+
+Merges parsing results into a single flattened object.
+Numeric indices are used for positional arguments.
+
+## Parameters
+
+### result
+
+[`CmdArgParseResult`](../interfaces/CmdArgParseResult.md)
+
+The raw parse result.
+
+### options?
+
+[`CmdArgParserOptions`](../interfaces/CmdArgParserOptions.md)
+
+CmdArgParser configuration options.
+
+## Returns
+
+`Record`\<`string` \| `number`, `any`\>
+
+A merged object containing all arguments.

package/docs/api/functions/completeSentences.md

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

package/docs/api/functions/concatText.md

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

package/docs/api/functions/countLLMTokens.md

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

package/docs/api/functions/countRegexMatches.md

@@ -8,7 +8,7 @@
 
 > **countRegexMatches**(`content`, `regex`): `number`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/count-regex-matches.ts:10](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/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/d10fb4cda65fc1975152a2c3ab327ecab008dea1/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/api/functions/createCallbacksTransformer.md

@@ -6,18 +6,18 @@
 
 # Function: createCallbacksTransformer()
 
-> **createCallbacksTransformer**\<`I`, `O`\>(`cb`): `TransformStream`\<`I`, `O`\>
+> **createCallbacksTransformer**\<`I`, `O`\>(`cb?`): `TransformStream`\<`I`, `O`\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/stream/create-callbacks-stream.ts:36](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/stream/create-callbacks-stream.ts#L36)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:90
 
-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.
-- `onStart`: Called once when the stream is initialized.
-- `onTransform`: Called for each tokenized message.
-- `onCompletion`: Called every time an AIStream completion message is received. This can occur multiple times when using e.g. OpenAI functions
-- `onFinal`: Called once when the stream is closed with the final completion message.
+Creates a transform stream that invokes optional callback functions during its lifecycle.
 
-This function is useful when you want to process a stream of messages and perform specific actions during the stream's lifecycle.
+### Key Features:
+- **Unified Cleanup**: The `onClose` hook ensures resource recovery happens once and only once.
+- **Zero-Copy Optimization**: If `onTransform` is omitted, it leverages the engine's internal
+  optimized identity path for maximum throughput.
+- **Cancellation Support**: Explicitly handles the `cancel` hook, critical for Web/RPC scenarios.
+- **Robustness**: Protects the stream lifecycle even if callbacks themselves throw errors.
 
 ## Type Parameters
 
@@ -31,23 +31,27 @@ This function is useful when you want to process a stream of messages and perfor
 
 ## Parameters
 
-### cb
+### cb?
 
-`undefined` | [`StreamCallbacksAndOptions`](../interfaces/StreamCallbacksAndOptions.md)\<`I`, `O`\>
+[`StreamCallbacksAndOptions`](../interfaces/StreamCallbacksAndOptions.md)\<`I`, `O`\>
+
+An object containing optional lifecycle callbacks.
 
 ## Returns
 
 `TransformStream`\<`I`, `O`\>
 
-A transform stream that encodes input messages as Uint8Array and allows the execution of custom logic through callbacks.
+A TransformStream that allows the execution of custom logic through callbacks.
 
 ## Example
 
-```ts
-const callbacks = {
-  onStart: async () => console.log('Stream started'),
-  onTransform: async (chunk) => console.log('Token:',chunk),
-  onFinal: async () => data.close()
-};
-const transformer = createCallbacksTransformer(callbacks);
+```typescript
+const transformer = createCallbacksTransformer({
+  onStart: (c) => c.enqueue("START_OF_STREAM"),
+  onTransform: (chunk) => chunk.toUpperCase(),
+  onClose: (status, reason) => {
+    console.log(`Stream closed with status: ${status}`);
+    myTaskHandle.release(); // Guaranteed cleanup
+  }
+});
 ```

package/docs/api/functions/createEmptyReadableStream.md

@@ -8,7 +8,7 @@
 
 > **createEmptyReadableStream**(): `ReadableStream`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/stream/create-empty-stream.ts:8](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/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/d10fb4cda65fc1975152a2c3ab327ecab008dea1/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/api/functions/createEndWithRepetitionDetector.md

@@ -6,9 +6,9 @@
 
 # Function: createEndWithRepetitionDetector()
 
-> **createEndWithRepetitionDetector**(`repetitionThreshold`): (`value`) => `null` \| `RegExpExecArray`
+> **createEndWithRepetitionDetector**(`repetitionThreshold`): (`value`) => `RegExpExecArray` \| `null`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/end-with-repeated-sequence.ts:3](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/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/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/end-with-repeated-sequence.ts#L3)
 
 ## Parameters
 
@@ -18,7 +18,7 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/end-with-repeated-sequenc
 
 ## Returns
 
-> (`value`): `null` \| `RegExpExecArray`
+> (`value`): `RegExpExecArray` \| `null`
 
 ### Parameters
 
@@ -28,4 +28,4 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/end-with-repeated-sequenc
 
 ### Returns
 
-`null` \| `RegExpExecArray`
+`RegExpExecArray` \| `null`

package/docs/api/functions/createEventStreamTransformer.md

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

package/docs/api/functions/createHfValueFunc.md

@@ -8,7 +8,7 @@
 
 > **createHfValueFunc**(`fn`): (`_data`) => `Function`
 
-Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:610
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:681
 
 ## Parameters
 

package/docs/api/functions/createLRUCache.md

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

package/docs/api/functions/createYamlObjectTag.md

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

package/docs/api/functions/dateToText.md

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

package/docs/api/functions/decodeCharset.md

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

package/docs/api/functions/defaultsWithConcat.md

@@ -8,7 +8,7 @@
 
 > **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/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/merge-with-concat.ts#L60)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/merge-with-concat.ts:60](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/merge-with-concat.ts#L60)
 
 Merges multiple source objects into the target object with a custom merging strategy.
 

package/docs/api/functions/detectCharset.md

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

package/docs/api/functions/encodeLLMTokens.md

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

package/docs/api/functions/ensureQuoted.md

@@ -8,7 +8,9 @@
 
 > **ensureQuoted**(`s`, `quoteChar`): `string`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/parse-command.ts:204](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/parse-command.ts#L204)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/utils.ts:104](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/utils.ts#L104)
+
+Ensures a string is wrapped in quotes.
 
 ## Parameters
 

package/docs/api/functions/evaluateExpression.md

@@ -0,0 +1,40 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / evaluateExpression
+
+# Function: evaluateExpression()
+
+> **evaluateExpression**(`code`, `scope`, `options`): `Promise`\<`any`\>
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/evaluator.ts:58](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/evaluator.ts#L58)
+
+Evaluates an expression string to its value.
+
+Logic sequence:
+1. Check if evaluation should be skipped.
+2. Match simple JS literals (true, false, null, undefined, NaN, Infinity).
+3. Check if it's a number.
+4. Perform path lookup in the scope (getByPath).
+5. Attempt execution as a JS expression or arrow function.
+6. Catch ReferenceError: Decide whether to fall back to raw text or return undefined based on options.
+7. Final fallback: Handle unquoting for quoted strings.
+
+## Parameters
+
+### code
+
+`string`
+
+### scope
+
+`any`
+
+### options
+
+[`CmdArgParserOptions`](../interfaces/CmdArgParserOptions.md)
+
+## Returns
+
+`Promise`\<`any`\>

package/docs/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: @isdk/ai-tools/node\_modules/.pnpm/events-ex@2.1.0/node\_modules/events-ex/lib/eventable.d.ts:48
+Defined in: @isdk/util/node\_modules/.pnpm/events-ex@2.1.1/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

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

package/docs/api/functions/expandEnv.md

@@ -8,7 +8,7 @@
 
 > **expandEnv**(`options`): `DotenvExpandOptions`
 
-Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:705
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:782
 
 Expand environment variables in the parsed object
 

package/docs/api/functions/expandObjEnv.md

@@ -8,7 +8,7 @@
 
 > **expandObjEnv**(`obj`, `options?`, `parsedObjs?`): `any`
 
-Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:732
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:809
 
 Expands environment variables in an object/array or string.
 

package/docs/api/functions/expandPath.md

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

package/docs/api/functions/expandPathInObject.md

@@ -8,7 +8,7 @@
 
 > **expandPathInObject**(`obj`, `pathKeys`, `config?`): `void`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/load-config.ts:85](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/load-config.ts#L85)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/load-config.ts:85](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/load-config.ts#L85)
 
 ## Parameters
 

package/docs/api/functions/expandPaths.md

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

package/docs/api/functions/extNameLevel.md

@@ -8,7 +8,7 @@
 
 > **extNameLevel**(`extName`): `number`
 
-Defined in: @isdk/util/dist/index.d.ts:449
+Defined in: @isdk/util/dist/index.d.ts:450
 
 Calculates the level of an extension name.
 

package/docs/api/functions/extractCodeBlock.md

@@ -0,0 +1,51 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / extractCodeBlock
+
+# Function: extractCodeBlock()
+
+> **extractCodeBlock**(`text`, `langOrOptions?`): `string` \| `CodeString` \| (`string` \| `CodeString`)[]
+
+Defined in: @isdk/util/dist/index.d.ts:1278
+
+Extracts fenced code block(s) from the input `text`, with support for nested path selectors.
+
+This function acts as a query engine for Markdown code blocks. It can extract
+single blocks, multiple blocks, or drill down into nested structures using
+CSS-like syntax.
+
+## Parameters
+
+### text
+
+`string`
+
+The input string containing Markdown.
+
+### langOrOptions?
+
+Either a language/selector string or a full ExtractCodeBlockOptions object.
+
+`string` | `ExtractCodeBlockOptions`
+
+## Returns
+
+`string` \| `CodeString` \| (`string` \| `CodeString`)[]
+
+A single CodeString, an array of CodeStrings (if `all: true`),
+         or the original `text` if no matches are found at the specified index.
+
+## Example
+
+```ts
+// Simple extraction (last block)
+const code = extractCodeBlock(input, 'js');
+
+// Nested extraction
+const inner = extractCodeBlock(input, 'md > ts');
+
+// Extract all matching blocks
+const all = extractCodeBlock(input, { lang: 'container > item', all: true });
+```

package/docs/api/functions/fileIsExists.md

@@ -6,9 +6,9 @@
 
 # Function: fileIsExists()
 
-> **fileIsExists**(`filepath`): `undefined` \| `boolean`
+> **fileIsExists**(`filepath`): `boolean` \| `undefined`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/load-file-from-paths.ts:23](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/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/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/load-file-from-paths.ts#L23)
 
 Checks if a file (not a directory) exists at the specified path.
 
@@ -22,7 +22,7 @@ The path to the file to check.
 
 ## Returns
 
-`undefined` \| `boolean`
+`boolean` \| `undefined`
 
 true if the file exists and is not a directory; otherwise, false.
 

package/docs/api/functions/filterValidFnScope.md

@@ -6,9 +6,9 @@
 
 # Function: filterValidFnScope()
 
-> **filterValidFnScope**(`scope?`): `undefined` \| `Record`\<`string`, `any`\>
+> **filterValidFnScope**(`scope?`): `Record`\<`string`, `any`\> \| `undefined`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/parse-js-json.ts:58](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/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/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/parse-js-json.ts#L58)
 
 ## Parameters
 
@@ -18,4 +18,4 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/parse-js-json.ts:58](http
 
 ## Returns
 
-`undefined` \| `Record`\<`string`, `any`\>
+`Record`\<`string`, `any`\> \| `undefined`

package/docs/api/functions/findIndexNonEmptyFrom.md

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