@isdk/ai-tool 0.5.8 → 0.7.0

package/docs/{classes → api/classes}/EventToolFunc.md

@@ -6,7 +6,62 @@
 
 # Class: EventToolFunc
 
-Defined in: [packages/ai-tool/src/funcs/event.ts:5](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/funcs/event.ts#L5)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event.ts:6](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/funcs/event.ts#L6)
+
+A manager for creating, registering, and executing reusable tool functions.
+
+`ToolFunc` provides a robust framework for defining functions with rich metadata,
+managing their lifecycle, and executing them through a centralized registry.
+It is the core component for creating modular and discoverable tools.
+
+Key Features:
+- **Rich Metadata**: Define functions with descriptions, parameters, tags, and titles, making them self-documenting.
+- **Static Registry**: A global, static registry (`ToolFunc.items`) allows any part of an application to access and run registered functions by name.
+- **Dependency Management**: Use the `depends` property to declare dependencies on other `ToolFunc`s, which are then auto-registered.
+- **Aliasing**: Assign multiple names to a function for flexibility.
+- **Lifecycle Hooks**: Use the `setup` method for one-time initialization logic when a `ToolFunc` instance is created.
+- **Parameter Handling**: Automatically handles both positional and named parameters.
+
+## Example
+
+```ts
+// 1. Define a helper function
+const getUser = new ToolFunc({
+  name: 'getUser',
+  description: 'Retrieves a user by ID.',
+  params: { id: { type: 'string', required: true } },
+  func: (params) => ({ id: params.id, name: 'John Doe' }),
+});
+
+// 2. Define a main function that depends on the helper
+const welcomeUser = new ToolFunc({
+  name: 'welcomeUser',
+  title: 'Welcome User',
+  description: 'Generates a welcome message for a user.',
+  params: { userId: 'string' },
+  depends: {
+    // By declaring this dependency, `getUser` will be auto-registered
+    // when `welcomeUser` is registered.
+    userFetcher: getUser,
+  },
+  func: function(params) {
+    // `this` is the ToolFunc instance, so we can use `runSync`
+    const user = this.runSync('userFetcher', { id: params.userId });
+    return `Hello, ${user.name}!`;
+  },
+});
+
+// 3. Register the main function. The dependency is registered automatically.
+welcomeUser.register();
+
+// 4. Run the function from anywhere using the static runner.
+async function main() {
+  const message = await ToolFunc.run('welcomeUser', { userId: '123' });
+  console.log(message); // Outputs: "Hello, John Doe!"
+}
+
+main();
+```
 
 ## Extends
 
@@ -20,9 +75,9 @@ Defined in: [packages/ai-tool/src/funcs/event.ts:5](https://github.com/isdk/ai-t
 
 ### new EventToolFunc()
 
-> **new EventToolFunc**(`name`, `options`): [`EventToolFunc`](EventToolFunc.md)
+> **new EventToolFunc**(`name`, `options`?): [`EventToolFunc`](EventToolFunc.md)
 
-Defined in: [packages/ai-tool/src/tool-func.ts:225](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L225)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:571](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L571)
 
 The initial value of Object.prototype.constructor is the standard built-in Object constructor.
 
@@ -30,12 +85,16 @@ The initial value of Object.prototype.constructor is the standard built-in Objec
 
 ##### name
 
+Can be a function name, a function implementation, or a configuration object.
+
 `string` | `Function` | [`FuncItem`](../interfaces/FuncItem.md)
 
-##### options
+##### options?
 
 `any` = `{}`
 
+Configuration options if not provided in the first argument.
+
 #### Returns
 
 [`EventToolFunc`](EventToolFunc.md)
@@ -50,7 +109,7 @@ The initial value of Object.prototype.constructor is the standard built-in Objec
 
 > **\_emitter**: [`EventEmitter`](EventEmitter.md)
 
-Defined in: [packages/ai-tool/src/funcs/event.ts:7](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/funcs/event.ts#L7)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event.ts:7](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/funcs/event.ts#L7)
 
 ***
 
@@ -58,7 +117,7 @@ Defined in: [packages/ai-tool/src/funcs/event.ts:7](https://github.com/isdk/ai-t
 
 > **$attributes**: `Properties`
 
-Defined in: node\_modules/.pnpm/property-manager@2.0.0/node\_modules/property-manager/lib/advance.d.ts:5
+Defined in: [property-manager.js/src/advance.d.ts:5](https://github.com/snowyu/property-manager.js/blob/e9ebf4c62be9b6d84e5868ed098df041a53bb90a/src/advance.d.ts#L5)
 
 #### Inherited from
 
@@ -70,7 +129,9 @@ Defined in: node\_modules/.pnpm/property-manager@2.0.0/node\_modules/property-ma
 
 > `optional` **alias**: `string` \| `string`[]
 
-Defined in: [packages/ai-tool/src/tool-func.ts:31](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L31)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:130](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L130)
+
+Optional aliases for the function name.
 
 #### Inherited from
 
@@ -78,11 +139,41 @@ Defined in: [packages/ai-tool/src/tool-func.ts:31](https://github.com/isdk/ai-to
 
 ***
 
+### asyncFeatures?
+
+> `optional` **asyncFeatures**: `number`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:144](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L144)
+
+A bitmask representing asynchronous features supported by the function, built from `AsyncFeatureBits`.
+This allows the system to understand if a function supports capabilities like cancellation or multi-tasking.
+
+#### See
+
+AsyncFeatureBits from `@src/utils/cancelable-ability.ts`
+
+#### Example
+
+```ts
+import { AsyncFeatures } from './utils';
+const func = new ToolFunc({
+  name: 'cancellableTask',
+  asyncFeatures: AsyncFeatures.Cancelable | AsyncFeatures.MultiTask,
+  // ...
+});
+```
+
+#### Inherited from
+
+[`ToolFunc`](ToolFunc.md).[`asyncFeatures`](ToolFunc.md#asyncfeatures)
+
+***
+
 ### constructor
 
 > **constructor**: `Function`
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:125
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:125
 
 The initial value of Object.prototype.constructor is the standard built-in Object constructor.
 
@@ -96,7 +187,7 @@ The initial value of Object.prototype.constructor is the standard built-in Objec
 
 > **defaultOptions**: `object`
 
-Defined in: node\_modules/.pnpm/property-manager@2.0.0/node\_modules/property-manager/lib/abstract.d.ts:74
+Defined in: [property-manager.js/src/abstract.d.ts:74](https://github.com/snowyu/property-manager.js/blob/e9ebf4c62be9b6d84e5868ed098df041a53bb90a/src/abstract.d.ts#L74)
 
 The default options for export and assign
 
@@ -114,11 +205,56 @@ The default options for export and assign
 
 ***
 
+### depends?
+
+> `optional` **depends**: `object`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:167](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L167)
+
+A map of dependencies this function has on other tool functions.
+Declaring dependencies ensures that they are automatically registered when this function is registered.
+This is crucial for building modular functions that rely on each other without needing to manage registration order manually.
+
+#### Index Signature
+
+\[`name`: `string`\]: [`ToolFunc`](ToolFunc.md)
+
+#### Example
+
+```ts
+const helperFunc = new ToolFunc({ name: 'helper', func: () => 'world' });
+const mainFunc = new ToolFunc({
+  name: 'main',
+  depends: {
+    helper: helperFunc,
+  },
+  func() {
+    // We can now safely run the dependency
+    const result = this.runSync('helper');
+    return `Hello, ${result}`;
+  }
+});
+// When mainFunc is registered, helperFunc will be registered automatically.
+mainFunc.register();
+```
+
+#### Inherited from
+
+[`ToolFunc`](ToolFunc.md).[`depends`](ToolFunc.md#depends)
+
+***
+
 ### description
 
 > **description**: `string` = `'Return event bus'`
 
-Defined in: [packages/ai-tool/src/funcs/event.ts:9](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/funcs/event.ts#L9)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event.ts:9](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/funcs/event.ts#L9)
+
+A detailed description of what the function does.
+
+#### Overrides
+
+[`ToolFunc`](ToolFunc.md).[`description`](ToolFunc.md#description)
 
 ***
 
@@ -126,7 +262,9 @@ Defined in: [packages/ai-tool/src/funcs/event.ts:9](https://github.com/isdk/ai-t
 
 > `optional` **isApi**: `boolean`
 
-Defined in: [packages/ai-tool/src/tool-func.ts:29](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L29)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:119](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L119)
+
+If true, indicates that this function should be treated as a server-side API.
 
 #### Inherited from
 
@@ -138,11 +276,13 @@ Defined in: [packages/ai-tool/src/tool-func.ts:29](https://github.com/isdk/ai-to
 
 > `optional` **name**: `string`
 
-Defined in: [packages/ai-tool/src/tool-func.ts:23](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L23)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:76](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L76)
+
+The unique name of the function.
 
 #### Inherited from
 
-[`ToolFunc`](ToolFunc.md).[`name`](ToolFunc.md#name-1)
+[`ToolFunc`](ToolFunc.md).[`name`](ToolFunc.md#name-3)
 
 ***
 
@@ -150,7 +290,7 @@ Defined in: [packages/ai-tool/src/tool-func.ts:23](https://github.com/isdk/ai-to
 
 > **nonExported1stChar**: `string`
 
-Defined in: node\_modules/.pnpm/property-manager@2.0.0/node\_modules/property-manager/lib/abstract.d.ts:78
+Defined in: [property-manager.js/src/abstract.d.ts:78](https://github.com/snowyu/property-manager.js/blob/e9ebf4c62be9b6d84e5868ed098df041a53bb90a/src/abstract.d.ts#L78)
 
 the property with the default prefix '$' will not be exported.
 
@@ -164,7 +304,9 @@ the property with the default prefix '$' will not be exported.
 
 > `optional` **params**: [`FuncParams`](../interfaces/FuncParams.md) \| [`FuncParam`](../interfaces/FuncParam.md)[]
 
-Defined in: [packages/ai-tool/src/tool-func.ts:24](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L24)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:81](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L81)
+
+Parameter definitions, which can be an object mapping names to definitions or an array for positional parameters.
 
 #### Inherited from
 
@@ -176,7 +318,9 @@ Defined in: [packages/ai-tool/src/tool-func.ts:24](https://github.com/isdk/ai-to
 
 > **result**: `string` = `'event'`
 
-Defined in: [packages/ai-tool/src/funcs/event.ts:10](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/funcs/event.ts#L10)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event.ts:10](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/funcs/event.ts#L10)
+
+The expected return type of the function, described as a string or a JSON schema object.
 
 #### Overrides
 
@@ -188,7 +332,9 @@ Defined in: [packages/ai-tool/src/funcs/event.ts:10](https://github.com/isdk/ai-
 
 > `optional` **scope**: `any`
 
-Defined in: [packages/ai-tool/src/tool-func.ts:26](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L26)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:91](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L91)
+
+The execution scope or context (`this`) for the function.
 
 #### Inherited from
 
@@ -200,7 +346,11 @@ Defined in: [packages/ai-tool/src/tool-func.ts:26](https://github.com/isdk/ai-to
 
 > `optional` **setup**: (`this`, `options`?) => `void`
 
-Defined in: [packages/ai-tool/src/tool-func.ts:28](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L28)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:114](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L114)
+
+A lifecycle hook called once during the `ToolFunc` instance's initialization.
+It allows for initial setup, state configuration, or property modification on the instance
+before it is used or registered. The `this` context is the `ToolFunc` instance itself.
 
 #### Parameters
 
@@ -212,10 +362,26 @@ Defined in: [packages/ai-tool/src/tool-func.ts:28](https://github.com/isdk/ai-to
 
 [`FuncItem`](../interfaces/FuncItem.md)
 
+The configuration options for the function.
+
 #### Returns
 
 `void`
 
+#### Example
+
+```ts
+const myFunc = new ToolFunc({
+  name: 'myFunc',
+  customState: 'initial',
+  setup() {
+    // `this` is the myFunc instance
+    this.customState = 'configured';
+  }
+});
+console.log(myFunc.customState); // Outputs: 'configured'
+```
+
 #### Inherited from
 
 [`ToolFunc`](ToolFunc.md).[`setup`](ToolFunc.md#setup)
@@ -226,7 +392,10 @@ Defined in: [packages/ai-tool/src/tool-func.ts:28](https://github.com/isdk/ai-to
 
 > `optional` **stream**: `boolean`
 
-Defined in: [packages/ai-tool/src/tool-func.ts:30](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L30)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:125](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L125)
+
+If true, indicates that the function has the *capability* to stream its output.
+Whether a specific call is streamed is determined by a `stream` property in the runtime parameters.
 
 #### Inherited from
 
@@ -238,7 +407,9 @@ Defined in: [packages/ai-tool/src/tool-func.ts:30](https://github.com/isdk/ai-to
 
 > `optional` **tags**: `string` \| `string`[]
 
-Defined in: [packages/ai-tool/src/tool-func.ts:27](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L27)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:96](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L96)
+
+Tags for grouping or filtering functions.
 
 #### Inherited from
 
@@ -246,11 +417,27 @@ Defined in: [packages/ai-tool/src/tool-func.ts:27](https://github.com/isdk/ai-to
 
 ***
 
+### title?
+
+> `optional` **title**: `string`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:177](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L177)
+
+A concise, human-readable title for the function, often used in UI or by AI.
+
+#### Inherited from
+
+[`ToolFunc`](ToolFunc.md).[`title`](ToolFunc.md#title)
+
+***
+
 ### aliases
 
 > `static` **aliases**: `object` = `{}`
 
-Defined in: [packages/ai-tool/src/tool-func.ts:58](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L58)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:305](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L305)
+
+A static map of aliases to their corresponding function names.
 
 #### Index Signature
 
@@ -266,7 +453,11 @@ Defined in: [packages/ai-tool/src/tool-func.ts:58](https://github.com/isdk/ai-to
 
 > `static` **dataPath**: `string`
 
-Defined in: [packages/ai-tool/src/tool-func.ts:59](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L59)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:312](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L312)
+
+A conventional property to designate a file path for saving the registered `ToolFunc` data.
+Note: The `ToolFunc` class itself does not implement persistence logic. It is up to the
+developer to use this path to save and load the `ToolFunc.items` registry if needed.
 
 #### Inherited from
 
@@ -278,7 +469,9 @@ Defined in: [packages/ai-tool/src/tool-func.ts:59](https://github.com/isdk/ai-to
 
 > `static` **items**: [`Funcs`](../interfaces/Funcs.md) = `{}`
 
-Defined in: [packages/ai-tool/src/tool-func.ts:57](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L57)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:300](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L300)
+
+A static registry of all `ToolFunc` instances, indexed by name.
 
 #### Inherited from
 
@@ -292,7 +485,7 @@ Defined in: [packages/ai-tool/src/tool-func.ts:57](https://github.com/isdk/ai-to
 
 > **get** **emitter**(): [`EventEmitter`](EventEmitter.md)
 
-Defined in: [packages/ai-tool/src/funcs/event.ts:12](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/funcs/event.ts#L12)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event.ts:12](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/funcs/event.ts#L12)
 
 ##### Returns
 
@@ -304,7 +497,10 @@ Defined in: [packages/ai-tool/src/funcs/event.ts:12](https://github.com/isdk/ai-
 
 > **arr2ObjParams**(`params`): `any`[]
 
-Defined in: [packages/ai-tool/src/tool-func.ts:269](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L269)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:629](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L629)
+
+Converts an array of positional arguments into a named parameters object.
+This is used internally to support functions defined with named parameters.
 
 #### Parameters
 
@@ -312,10 +508,14 @@ Defined in: [packages/ai-tool/src/tool-func.ts:269](https://github.com/isdk/ai-t
 
 `any`[]
 
+An array of positional arguments.
+
 #### Returns
 
 `any`[]
 
+An array containing a single parameters object.
+
 #### Inherited from
 
 [`ToolFunc`](ToolFunc.md).[`arr2ObjParams`](ToolFunc.md#arr2objparams)
@@ -326,7 +526,7 @@ Defined in: [packages/ai-tool/src/tool-func.ts:269](https://github.com/isdk/ai-t
 
 > **assign**(`src`, `options`?): `this`
 
-Defined in: node\_modules/.pnpm/property-manager@2.0.0/node\_modules/property-manager/lib/abstract.d.ts:106
+Defined in: [property-manager.js/src/abstract.d.ts:106](https://github.com/snowyu/property-manager.js/blob/e9ebf4c62be9b6d84e5868ed098df041a53bb90a/src/abstract.d.ts#L106)
 
 Assign the values from the src object.
 
@@ -358,7 +558,7 @@ this object
 
 > **assignProperty**(`src`, `name`, `value`, `attrs`?, `options`?): `void`
 
-Defined in: node\_modules/.pnpm/property-manager@2.0.0/node\_modules/property-manager/lib/abstract.d.ts:117
+Defined in: [property-manager.js/src/abstract.d.ts:117](https://github.com/snowyu/property-manager.js/blob/e9ebf4c62be9b6d84e5868ed098df041a53bb90a/src/abstract.d.ts#L117)
 
 Assign a property of src to this object.
 
@@ -406,7 +606,7 @@ the attributes object
 
 > `abstract` **assignPropertyTo**(`dest`, `src`, `name`, `value`, `attrs`?, `options`?): `void`
 
-Defined in: node\_modules/.pnpm/property-manager@2.0.0/node\_modules/property-manager/lib/abstract.d.ts:131
+Defined in: [property-manager.js/src/abstract.d.ts:131](https://github.com/snowyu/property-manager.js/blob/e9ebf4c62be9b6d84e5868ed098df041a53bb90a/src/abstract.d.ts#L131)
 
 Assign the property value from the src to destination object.
 
@@ -460,7 +660,7 @@ The attributes object of the property
 
 > **assignTo**(`dest`?, `options`?): `any`
 
-Defined in: node\_modules/.pnpm/property-manager@2.0.0/node\_modules/property-manager/lib/abstract.d.ts:191
+Defined in: [property-manager.js/src/abstract.d.ts:191](https://github.com/snowyu/property-manager.js/blob/e9ebf4c62be9b6d84e5868ed098df041a53bb90a/src/abstract.d.ts#L191)
 
 Assign this attributes to the dest object
 
@@ -492,7 +692,7 @@ the dest object
 
 > **clone**(`options`?): `any`
 
-Defined in: node\_modules/.pnpm/property-manager@2.0.0/node\_modules/property-manager/lib/abstract.d.ts:155
+Defined in: [property-manager.js/src/abstract.d.ts:155](https://github.com/snowyu/property-manager.js/blob/e9ebf4c62be9b6d84e5868ed098df041a53bb90a/src/abstract.d.ts#L155)
 
 Create a new object with the same values of attributes.
 
@@ -518,7 +718,7 @@ the new object
 
 > **cloneTo**(`dest`, `options`?): `any`
 
-Defined in: node\_modules/.pnpm/property-manager@2.0.0/node\_modules/property-manager/lib/abstract.d.ts:148
+Defined in: [property-manager.js/src/abstract.d.ts:148](https://github.com/snowyu/property-manager.js/blob/e9ebf4c62be9b6d84e5868ed098df041a53bb90a/src/abstract.d.ts#L148)
 
 Create and assign the values to the destination object.
 
@@ -550,7 +750,7 @@ the new dest object
 
 > `abstract` **defineProperties**(`aProperties`): `any`
 
-Defined in: node\_modules/.pnpm/property-manager@2.0.0/node\_modules/property-manager/lib/abstract.d.ts:89
+Defined in: [property-manager.js/src/abstract.d.ts:89](https://github.com/snowyu/property-manager.js/blob/e9ebf4c62be9b6d84e5868ed098df041a53bb90a/src/abstract.d.ts#L89)
 
 Define the attributes of this object.
 
@@ -576,7 +776,7 @@ the defined attributes of the object
 
 > **exportTo**(`dest`, `options`?): `any`
 
-Defined in: node\_modules/.pnpm/property-manager@2.0.0/node\_modules/property-manager/lib/abstract.d.ts:173
+Defined in: [property-manager.js/src/abstract.d.ts:173](https://github.com/snowyu/property-manager.js/blob/e9ebf4c62be9b6d84e5868ed098df041a53bb90a/src/abstract.d.ts#L173)
 
 Export attributes to the dest json object.
 
@@ -608,12 +808,16 @@ the dest object.
 
 > **func**(): [`EventEmitter`](EventEmitter.md)
 
-Defined in: [packages/ai-tool/src/funcs/event.ts:17](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/funcs/event.ts#L17)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event.ts:16](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/funcs/event.ts#L16)
+
+The actual function implementation.
 
 #### Returns
 
 [`EventEmitter`](EventEmitter.md)
 
+The result of the function.
+
 #### Overrides
 
 [`ToolFunc`](ToolFunc.md).[`func`](ToolFunc.md#func)
@@ -624,7 +828,11 @@ Defined in: [packages/ai-tool/src/funcs/event.ts:17](https://github.com/isdk/ai-
 
 > **getFunc**(`name`?): `any`
 
-Defined in: [packages/ai-tool/src/tool-func.ts:322](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L322)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:720](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L720)
+
+Gets a bound function reference for execution with named parameters.
+If a name is provided, it retrieves a different function from the registry.
+Otherwise, it returns a bound version of this instance's `runSync`.
 
 #### Parameters
 
@@ -632,10 +840,14 @@ Defined in: [packages/ai-tool/src/tool-func.ts:322](https://github.com/isdk/ai-t
 
 `string`
 
+Optional name of the function to retrieve.
+
 #### Returns
 
 `any`
 
+A function reference or `undefined` if not found.
+
 #### Inherited from
 
 [`ToolFunc`](ToolFunc.md).[`getFunc`](ToolFunc.md#getfunc)
@@ -646,7 +858,11 @@ Defined in: [packages/ai-tool/src/tool-func.ts:322](https://github.com/isdk/ai-t
 
 > **getFuncWithPos**(`name`?): `any`
 
-Defined in: [packages/ai-tool/src/tool-func.ts:346](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L346)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:777](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L777)
+
+Gets a bound function reference suitable for positional argument execution.
+If a name is provided, it retrieves a different function from the registry.
+Otherwise, it returns a bound version of this instance's `runWithPosSync`.
 
 #### Parameters
 
@@ -654,10 +870,14 @@ Defined in: [packages/ai-tool/src/tool-func.ts:346](https://github.com/isdk/ai-t
 
 `string`
 
+Optional name of the function to retrieve.
+
 #### Returns
 
 `any`
 
+A function reference or `undefined` if not found.
+
 #### Inherited from
 
 [`ToolFunc`](ToolFunc.md).[`getFuncWithPos`](ToolFunc.md#getfuncwithpos)
@@ -668,7 +888,7 @@ Defined in: [packages/ai-tool/src/tool-func.ts:346](https://github.com/isdk/ai-t
 
 > `abstract` **getProperties**(): `PropDescriptors`
 
-Defined in: node\_modules/.pnpm/property-manager@2.0.0/node\_modules/property-manager/lib/abstract.d.ts:98
+Defined in: [property-manager.js/src/abstract.d.ts:98](https://github.com/snowyu/property-manager.js/blob/e9ebf4c62be9b6d84e5868ed098df041a53bb90a/src/abstract.d.ts#L98)
 
 Get the defined attributes.
 
@@ -688,7 +908,9 @@ the descriptors of properties object
 
 > **hasAsyncFeature**(`feature`): `boolean`
 
-Defined in: [packages/ai-tool/src/tool-func.ts:351](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L351)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:787](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L787)
+
+Checks if the current function instance supports a specific async feature.
 
 #### Parameters
 
@@ -696,10 +918,14 @@ Defined in: [packages/ai-tool/src/tool-func.ts:351](https://github.com/isdk/ai-t
 
 [`AsyncFeatureBits`](../enumerations/AsyncFeatureBits.md)
 
+The async feature bit to check for.
+
 #### Returns
 
 `boolean`
 
+`true` if the feature is supported, otherwise `false`.
+
 #### Inherited from
 
 [`ToolFunc`](ToolFunc.md).[`hasAsyncFeature`](ToolFunc.md#hasasyncfeature)
@@ -710,7 +936,7 @@ Defined in: [packages/ai-tool/src/tool-func.ts:351](https://github.com/isdk/ai-t
 
 > **hasOwnProperty**(`v`): `boolean`
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:140
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:140
 
 Determines whether an object has a property with the specified name.
 
@@ -736,7 +962,7 @@ A property name.
 
 > **initialize**(`src`?): `this`
 
-Defined in: node\_modules/.pnpm/property-manager@2.0.0/node\_modules/property-manager/lib/abstract.d.ts:139
+Defined in: [property-manager.js/src/abstract.d.ts:139](https://github.com/snowyu/property-manager.js/blob/e9ebf4c62be9b6d84e5868ed098df041a53bb90a/src/abstract.d.ts#L139)
 
 Initialize object and assign attribute values from src if src exists.
 
@@ -762,7 +988,7 @@ this object.
 
 > **isPrototypeOf**(`v`): `boolean`
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:146
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:146
 
 Determines whether an object exists in another object's prototype chain.
 
@@ -788,7 +1014,7 @@ Another object whose prototype chain is to be checked.
 
 > **isSame**(`src`, `options`?): `boolean`
 
-Defined in: node\_modules/.pnpm/property-manager@2.0.0/node\_modules/property-manager/lib/abstract.d.ts:200
+Defined in: [property-manager.js/src/abstract.d.ts:200](https://github.com/snowyu/property-manager.js/blob/e9ebf4c62be9b6d84e5868ed098df041a53bb90a/src/abstract.d.ts#L200)
 
 Check the src object whether “equals” this object.
 
@@ -818,7 +1044,15 @@ The source object
 
 > **isStream**(`params`): `undefined` \| `boolean`
 
-Defined in: [packages/ai-tool/src/tool-func.ts:357](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L357)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:805](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L805)
+
+Determines if a function call should produce a stream.
+
+The logic is as follows:
+1. It first checks if the function is generally capable of streaming (`this.stream`).
+2. If it is, it then checks if a `stream` parameter is formally declared in the function's `params` definition.
+3. If both are true, the method returns the value of the `stream` property from the runtime `params` object.
+Otherwise, it returns the function's static `stream` capability.
 
 #### Parameters
 
@@ -826,10 +1060,14 @@ Defined in: [packages/ai-tool/src/tool-func.ts:357](https://github.com/isdk/ai-t
 
 `any`
 
+The runtime parameters passed to the function call.
+
 #### Returns
 
 `undefined` \| `boolean`
 
+`true` if the call should be streamed, `false` or `undefined` otherwise.
+
 #### Inherited from
 
 [`ToolFunc`](ToolFunc.md).[`isStream`](ToolFunc.md#isstream)
@@ -840,7 +1078,7 @@ Defined in: [packages/ai-tool/src/tool-func.ts:357](https://github.com/isdk/ai-t
 
 > **mergeTo**(`dest`, `options`?): `any`
 
-Defined in: node\_modules/.pnpm/property-manager@2.0.0/node\_modules/property-manager/lib/abstract.d.ts:164
+Defined in: [property-manager.js/src/abstract.d.ts:164](https://github.com/snowyu/property-manager.js/blob/e9ebf4c62be9b6d84e5868ed098df041a53bb90a/src/abstract.d.ts#L164)
 
 Merge this attributes to dest object.
 
@@ -872,7 +1110,10 @@ the dest object.
 
 > **obj2ArrParams**(`params`?): `any`[]
 
-Defined in: [packages/ai-tool/src/tool-func.ts:282](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L282)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:648](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L648)
+
+Converts a named parameters object into an array of positional arguments.
+This is used for functions defined with positional parameters.
 
 #### Parameters
 
@@ -880,10 +1121,14 @@ Defined in: [packages/ai-tool/src/tool-func.ts:282](https://github.com/isdk/ai-t
 
 `any`
 
+A named parameters object.
+
 #### Returns
 
 `any`[]
 
+An array of positional arguments.
+
 #### Inherited from
 
 [`ToolFunc`](ToolFunc.md).[`obj2ArrParams`](ToolFunc.md#obj2arrparams)
@@ -894,7 +1139,7 @@ Defined in: [packages/ai-tool/src/tool-func.ts:282](https://github.com/isdk/ai-t
 
 > **propertyIsEnumerable**(`v`): `boolean`
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:152
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:152
 
 Determines whether a specified property is enumerable.
 
@@ -920,12 +1165,17 @@ A property name.
 
 > **register**(): `boolean` \| [`ToolFunc`](ToolFunc.md)
 
-Defined in: [packages/ai-tool/src/tool-func.ts:252](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L252)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:602](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L602)
+
+Registers the current `ToolFunc` instance into the static registry.
+Also registers any declared dependencies.
 
 #### Returns
 
 `boolean` \| [`ToolFunc`](ToolFunc.md)
 
+The instance itself upon successful registration, or `false` if it already exists.
+
 #### Inherited from
 
 [`ToolFunc`](ToolFunc.md).[`register`](ToolFunc.md#register)
@@ -936,7 +1186,9 @@ Defined in: [packages/ai-tool/src/tool-func.ts:252](https://github.com/isdk/ai-t
 
 > **run**(`params`?): `Promise`\<`any`\>
 
-Defined in: [packages/ai-tool/src/tool-func.ts:309](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L309)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:686](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L686)
+
+Executes the function asynchronously with a named parameters object.
 
 #### Parameters
 
@@ -944,10 +1196,14 @@ Defined in: [packages/ai-tool/src/tool-func.ts:309](https://github.com/isdk/ai-t
 
 `any`
 
+The parameters object for the function.
+
 #### Returns
 
 `Promise`\<`any`\>
 
+A promise that resolves with the function's result.
+
 #### Inherited from
 
 [`ToolFunc`](ToolFunc.md).[`run`](ToolFunc.md#run)
@@ -958,7 +1214,10 @@ Defined in: [packages/ai-tool/src/tool-func.ts:309](https://github.com/isdk/ai-t
 
 > **runAs**(`name`, `params`?): `Promise`\<`any`\>
 
-Defined in: [packages/ai-tool/src/tool-func.ts:313](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L313)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:697](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L697)
+
+Asynchronously executes another registered function by name.
+This method delegates to `runAsSync()` internally.
 
 #### Parameters
 
@@ -966,14 +1225,20 @@ Defined in: [packages/ai-tool/src/tool-func.ts:313](https://github.com/isdk/ai-t
 
 `string`
 
+The name of the target function to run.
+
 ##### params?
 
 `any`
 
+Optional parameters to pass to the function.
+
 #### Returns
 
 `Promise`\<`any`\>
 
+A promise that resolves with the result of the function execution.
+
 #### Inherited from
 
 [`ToolFunc`](ToolFunc.md).[`runAs`](ToolFunc.md#runas)
@@ -984,7 +1249,10 @@ Defined in: [packages/ai-tool/src/tool-func.ts:313](https://github.com/isdk/ai-t
 
 > **runAsSync**(`name`, `params`?): `any`
 
-Defined in: [packages/ai-tool/src/tool-func.ts:317](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L317)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:708](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L708)
+
+Synchronously executes another registered function by name.
+This is a convenience method that forwards the call to the static `runSync()` method.
 
 #### Parameters
 
@@ -992,14 +1260,20 @@ Defined in: [packages/ai-tool/src/tool-func.ts:317](https://github.com/isdk/ai-t
 
 `string`
 
+The name of the target function to run.
+
 ##### params?
 
 `any`
 
+Optional parameters to pass to the function.
+
 #### Returns
 
 `any`
 
+The result of the function execution.
+
 #### Inherited from
 
 [`ToolFunc`](ToolFunc.md).[`runAsSync`](ToolFunc.md#runassync)
@@ -1010,7 +1284,9 @@ Defined in: [packages/ai-tool/src/tool-func.ts:317](https://github.com/isdk/ai-t
 
 > **runSync**(`params`?): `any`
 
-Defined in: [packages/ai-tool/src/tool-func.ts:295](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L295)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:667](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L667)
+
+Executes the function synchronously with a named parameters object.
 
 #### Parameters
 
@@ -1018,10 +1294,18 @@ Defined in: [packages/ai-tool/src/tool-func.ts:295](https://github.com/isdk/ai-t
 
 `any`
 
+The parameters object for the function.
+
 #### Returns
 
 `any`
 
+The result of the function execution.
+
+#### Throws
+
+Will throw an error if an array of parameters is passed to a function that expects an object.
+
 #### Inherited from
 
 [`ToolFunc`](ToolFunc.md).[`runSync`](ToolFunc.md#runsync)
@@ -1032,7 +1316,10 @@ Defined in: [packages/ai-tool/src/tool-func.ts:295](https://github.com/isdk/ai-t
 
 > **runWithPos**(...`params`): `Promise`\<`any`\>
 
-Defined in: [packages/ai-tool/src/tool-func.ts:338](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L338)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:755](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L755)
+
+Executes the function asynchronously using positional arguments.
+Delegates to `runWithPosSync()` internally.
 
 #### Parameters
 
@@ -1040,10 +1327,14 @@ Defined in: [packages/ai-tool/src/tool-func.ts:338](https://github.com/isdk/ai-t
 
 ...`any`[]
 
+Positional arguments passed to the function.
+
 #### Returns
 
 `Promise`\<`any`\>
 
+A promise that resolves with the result of the function execution.
+
 #### Inherited from
 
 [`ToolFunc`](ToolFunc.md).[`runWithPos`](ToolFunc.md#runwithpos)
@@ -1054,7 +1345,10 @@ Defined in: [packages/ai-tool/src/tool-func.ts:338](https://github.com/isdk/ai-t
 
 > **runWithPosAs**(`name`, ...`params`): `Promise`\<`any`\>
 
-Defined in: [packages/ai-tool/src/tool-func.ts:342](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L342)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:766](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L766)
+
+Asynchronously executes another function by name using positional arguments.
+Delegates to `runWithPosAsSync()` internally.
 
 #### Parameters
 
@@ -1062,14 +1356,20 @@ Defined in: [packages/ai-tool/src/tool-func.ts:342](https://github.com/isdk/ai-t
 
 `string`
 
+The name of the target function to run.
+
 ##### params
 
 ...`any`[]
 
+Positional arguments to pass to the function.
+
 #### Returns
 
 `Promise`\<`any`\>
 
+A promise that resolves with the result of the function execution.
+
 #### Inherited from
 
 [`ToolFunc`](ToolFunc.md).[`runWithPosAs`](ToolFunc.md#runwithposas)
@@ -1080,7 +1380,10 @@ Defined in: [packages/ai-tool/src/tool-func.ts:342](https://github.com/isdk/ai-t
 
 > **runWithPosAsSync**(`name`, ...`params`): `any`
 
-Defined in: [packages/ai-tool/src/tool-func.ts:334](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L334)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:745](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L745)
+
+Synchronously executes another function by name using positional arguments.
+This is a convenience wrapper around the static `runWithPosSync()` method.
 
 #### Parameters
 
@@ -1088,14 +1391,20 @@ Defined in: [packages/ai-tool/src/tool-func.ts:334](https://github.com/isdk/ai-t
 
 `string`
 
+The name of the target function to run.
+
 ##### params
 
 ...`any`[]
 
+Positional arguments to pass to the function.
+
 #### Returns
 
 `any`
 
+The result of the function execution.
+
 #### Inherited from
 
 [`ToolFunc`](ToolFunc.md).[`runWithPosAsSync`](ToolFunc.md#runwithposassync)
@@ -1106,7 +1415,10 @@ Defined in: [packages/ai-tool/src/tool-func.ts:334](https://github.com/isdk/ai-t
 
 > **runWithPosSync**(...`params`): `any`
 
-Defined in: [packages/ai-tool/src/tool-func.ts:327](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L327)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:731](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L731)
+
+Executes the function synchronously using positional arguments.
+If the function expects named parameters, it converts the arguments automatically.
 
 #### Parameters
 
@@ -1114,10 +1426,14 @@ Defined in: [packages/ai-tool/src/tool-func.ts:327](https://github.com/isdk/ai-t
 
 ...`any`[]
 
+Positional arguments passed to the function.
+
 #### Returns
 
 `any`
 
+The result of the function execution.
+
 #### Inherited from
 
 [`ToolFunc`](ToolFunc.md).[`runWithPosSync`](ToolFunc.md#runwithpossync)
@@ -1128,7 +1444,7 @@ Defined in: [packages/ai-tool/src/tool-func.ts:327](https://github.com/isdk/ai-t
 
 > **toJSON**(): `any`
 
-Defined in: node\_modules/.pnpm/property-manager@2.0.0/node\_modules/property-manager/lib/abstract.d.ts:182
+Defined in: [property-manager.js/src/abstract.d.ts:182](https://github.com/snowyu/property-manager.js/blob/e9ebf4c62be9b6d84e5868ed098df041a53bb90a/src/abstract.d.ts#L182)
 
 #### Returns
 
@@ -1144,7 +1460,7 @@ Defined in: node\_modules/.pnpm/property-manager@2.0.0/node\_modules/property-ma
 
 > **toLocaleString**(): `string`
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:131
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:131
 
 Returns a date converted to a string using the current locale.
 
@@ -1162,7 +1478,7 @@ Returns a date converted to a string using the current locale.
 
 > **toObject**(`options`?): `any`
 
-Defined in: node\_modules/.pnpm/property-manager@2.0.0/node\_modules/property-manager/lib/abstract.d.ts:181
+Defined in: [property-manager.js/src/abstract.d.ts:181](https://github.com/snowyu/property-manager.js/blob/e9ebf4c62be9b6d84e5868ed098df041a53bb90a/src/abstract.d.ts#L181)
 
 Convert the attributes to the json object
 
@@ -1188,7 +1504,7 @@ the json object.
 
 > **toString**(): `string`
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:128
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:128
 
 Returns a string representation of an object.
 
@@ -1206,12 +1522,16 @@ Returns a string representation of an object.
 
 > **unregister**(): `any`
 
-Defined in: [packages/ai-tool/src/tool-func.ts:265](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L265)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:619](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L619)
+
+Removes the current `ToolFunc` instance from the static registry.
 
 #### Returns
 
 `any`
 
+The instance that was unregistered.
+
 #### Inherited from
 
 [`ToolFunc`](ToolFunc.md).[`unregister`](ToolFunc.md#unregister)
@@ -1222,7 +1542,7 @@ Defined in: [packages/ai-tool/src/tool-func.ts:265](https://github.com/isdk/ai-t
 
 > **valueOf**(): `Object`
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:134
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:134
 
 Returns the primitive value of the specified object.
 
@@ -1242,7 +1562,7 @@ Returns the primitive value of the specified object.
 
 > `static` **assign**\<`T`, `U`\>(`target`, `source`): `T` & `U`
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es2015.core.d.ts:286
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es2015.core.d.ts:286
 
 Copy the values of all of the enumerable own properties from one or more source objects to a
 target object. Returns the target object.
@@ -1279,7 +1599,7 @@ The source object from which to copy properties.
 
 > `static` **assign**\<`T`, `U`, `V`\>(`target`, `source1`, `source2`): `T` & `U` & `V`
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es2015.core.d.ts:295
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es2015.core.d.ts:295
 
 Copy the values of all of the enumerable own properties from one or more source objects to a
 target object. Returns the target object.
@@ -1324,7 +1644,7 @@ The second source object from which to copy properties.
 
 > `static` **assign**\<`T`, `U`, `V`, `W`\>(`target`, `source1`, `source2`, `source3`): `T` & `U` & `V` & `W`
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es2015.core.d.ts:305
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es2015.core.d.ts:305
 
 Copy the values of all of the enumerable own properties from one or more source objects to a
 target object. Returns the target object.
@@ -1377,7 +1697,7 @@ The third source object from which to copy properties.
 
 > `static` **assign**(`target`, ...`sources`): `any`
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es2015.core.d.ts:313
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es2015.core.d.ts:313
 
 Copy the values of all of the enumerable own properties from one or more source objects to a
 target object. Returns the target object.
@@ -1412,7 +1732,7 @@ One or more source objects from which to copy properties
 
 > `static` **create**(`o`): `any`
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:188
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:188
 
 Creates an object that has the specified prototype or that has null prototype.
 
@@ -1436,7 +1756,7 @@ Object to use as a prototype. May be null.
 
 > `static` **create**(`o`, `properties`): `any`
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:195
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:195
 
 Creates an object that has the specified prototype, and that optionally contains specified properties.
 
@@ -1468,7 +1788,7 @@ JavaScript object that contains one or more property descriptors.
 
 > `static` **defineProperties**(`aTarget`, `aProperties`, `recreate`?): `any`
 
-Defined in: node\_modules/.pnpm/property-manager@2.0.0/node\_modules/property-manager/lib/advance.d.ts:11
+Defined in: [property-manager.js/src/advance.d.ts:11](https://github.com/snowyu/property-manager.js/blob/e9ebf4c62be9b6d84e5868ed098df041a53bb90a/src/advance.d.ts#L11)
 
 Adds one or more properties to an object, and/or modifies attributes of existing properties.
 
@@ -1500,7 +1820,7 @@ Adds one or more properties to an object, and/or modifies attributes of existing
 
 > `static` **defineProperty**\<`T`\>(`o`, `p`, `attributes`): `T`
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:203
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:203
 
 Adds a property to an object, or modifies attributes of an existing property.
 
@@ -1544,7 +1864,7 @@ Descriptor for the property. It can be for a data property or an accessor proper
 
 > `static` **entries**\<`T`\>(`o`): \[`string`, `T`\][]
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es2017.object.d.ts:36
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es2017.object.d.ts:36
 
 Returns an array of key/values of the enumerable own properties of an object
 
@@ -1572,7 +1892,7 @@ Object that contains the properties and methods. This can be an object that you
 
 > `static` **entries**(`o`): \[`string`, `any`\][]
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es2017.object.d.ts:42
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es2017.object.d.ts:42
 
 Returns an array of key/values of the enumerable own properties of an object
 
@@ -1598,7 +1918,7 @@ Object that contains the properties and methods. This can be an object that you
 
 > `static` **freeze**\<`T`\>(`f`): `T`
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:222
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:222
 
 Prevents the modification of existing property attributes and values, and prevents the addition of new properties.
 
@@ -1626,7 +1946,7 @@ Object on which to lock the attributes.
 
 > `static` **freeze**\<`T`, `U`\>(`o`): `Readonly`\<`T`\>
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:228
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:228
 
 Prevents the modification of existing property attributes and values, and prevents the addition of new properties.
 
@@ -1656,7 +1976,7 @@ Object on which to lock the attributes.
 
 > `static` **freeze**\<`T`\>(`o`): `Readonly`\<`T`\>
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:234
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:234
 
 Prevents the modification of existing property attributes and values, and prevents the addition of new properties.
 
@@ -1688,7 +2008,7 @@ Object on which to lock the attributes.
 
 > `static` **fromEntries**\<`T`\>(`entries`): `object`
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es2019.object.d.ts:26
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es2019.object.d.ts:26
 
 Returns an object created by key-value entries for properties and methods
 
@@ -1716,7 +2036,7 @@ An iterable object that contains key-value entries for properties and methods.
 
 > `static` **fromEntries**(`entries`): `any`
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es2019.object.d.ts:32
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es2019.object.d.ts:32
 
 Returns an object created by key-value entries for properties and methods
 
@@ -1742,7 +2062,9 @@ An iterable object that contains key-value entries for properties and methods.
 
 > `static` **get**(`name`): [`ToolFunc`](ToolFunc.md)
 
-Defined in: [packages/ai-tool/src/tool-func.ts:61](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L61)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:319](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L319)
+
+Retrieves a registered function by its name or alias.
 
 #### Parameters
 
@@ -1750,10 +2072,14 @@ Defined in: [packages/ai-tool/src/tool-func.ts:61](https://github.com/isdk/ai-to
 
 `string`
 
+The name or alias of the function to retrieve.
+
 #### Returns
 
 [`ToolFunc`](ToolFunc.md)
 
+The `ToolFunc` instance if found, otherwise `undefined`.
+
 #### Inherited from
 
 [`ToolFunc`](ToolFunc.md).[`get`](ToolFunc.md#get)
@@ -1764,7 +2090,9 @@ Defined in: [packages/ai-tool/src/tool-func.ts:61](https://github.com/isdk/ai-to
 
 > `static` **getAllByTag**(`tagName`): [`ToolFunc`](ToolFunc.md)[]
 
-Defined in: [packages/ai-tool/src/tool-func.ts:93](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L93)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:365](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L365)
+
+Retrieves all registered functions that have a specific tag.
 
 #### Parameters
 
@@ -1772,10 +2100,14 @@ Defined in: [packages/ai-tool/src/tool-func.ts:93](https://github.com/isdk/ai-to
 
 `string`
 
+The tag to search for.
+
 #### Returns
 
 [`ToolFunc`](ToolFunc.md)[]
 
+An array of matching `ToolFunc` instances.
+
 #### Inherited from
 
 [`ToolFunc`](ToolFunc.md).[`getAllByTag`](ToolFunc.md#getallbytag)
@@ -1786,7 +2118,9 @@ Defined in: [packages/ai-tool/src/tool-func.ts:93](https://github.com/isdk/ai-to
 
 > `static` **getByTag**(`tagName`): `undefined` \| [`ToolFunc`](ToolFunc.md)
 
-Defined in: [packages/ai-tool/src/tool-func.ts:73](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L73)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:340](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L340)
+
+Finds the first registered function that has a specific tag.
 
 #### Parameters
 
@@ -1794,10 +2128,14 @@ Defined in: [packages/ai-tool/src/tool-func.ts:73](https://github.com/isdk/ai-to
 
 `string`
 
+The tag to search for.
+
 #### Returns
 
 `undefined` \| [`ToolFunc`](ToolFunc.md)
 
+The first matching `ToolFunc` instance, or `undefined` if none is found.
+
 #### Inherited from
 
 [`ToolFunc`](ToolFunc.md).[`getByTag`](ToolFunc.md#getbytag)
@@ -1808,7 +2146,10 @@ Defined in: [packages/ai-tool/src/tool-func.ts:73](https://github.com/isdk/ai-to
 
 > `static` **getFunc**(`name`): `any`
 
-Defined in: [packages/ai-tool/src/tool-func.ts:134](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L134)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:431](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L431)
+
+Retrieves a bound, runnable function reference for a registered function.
+This reference is suitable for execution with an object of named parameters.
 
 #### Parameters
 
@@ -1816,10 +2157,14 @@ Defined in: [packages/ai-tool/src/tool-func.ts:134](https://github.com/isdk/ai-t
 
 `string`
 
+The name of the function.
+
 #### Returns
 
 `any`
 
+A bound function reference, or `undefined` if not found.
+
 #### Inherited from
 
 [`ToolFunc`](ToolFunc.md).[`getFunc`](ToolFunc.md#getfunc-2)
@@ -1830,7 +2175,10 @@ Defined in: [packages/ai-tool/src/tool-func.ts:134](https://github.com/isdk/ai-t
 
 > `static` **getFuncWithPos**(`name`): `any`
 
-Defined in: [packages/ai-tool/src/tool-func.ts:155](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L155)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:472](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L472)
+
+Retrieves a bound, runnable function reference for a registered function.
+This reference is suitable for execution with positional arguments.
 
 #### Parameters
 
@@ -1838,10 +2186,14 @@ Defined in: [packages/ai-tool/src/tool-func.ts:155](https://github.com/isdk/ai-t
 
 `string`
 
+The name of the function.
+
 #### Returns
 
 `any`
 
+A bound function reference, or `undefined` if not found.
+
 #### Inherited from
 
 [`ToolFunc`](ToolFunc.md).[`getFuncWithPos`](ToolFunc.md#getfuncwithpos-2)
@@ -1852,7 +2204,7 @@ Defined in: [packages/ai-tool/src/tool-func.ts:155](https://github.com/isdk/ai-t
 
 > `static` **getOwnPropertyDescriptor**(`o`, `p`): `undefined` \| `PropertyDescriptor`
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:175
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:175
 
 Gets the own property descriptor of the specified object.
 An own property descriptor is one that is defined directly on the object and is not inherited from the object's prototype.
@@ -1885,7 +2237,7 @@ Name of the property.
 
 > `static` **getOwnPropertyDescriptors**\<`T`\>(`o`): \{ \[P in string \| number \| symbol\]: TypedPropertyDescriptor\<T\[P\]\> \} & `object`
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es2017.object.d.ts:48
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es2017.object.d.ts:48
 
 Returns an object containing all own property descriptors of an object
 
@@ -1915,7 +2267,7 @@ Object that contains the properties and methods. This can be an object that you
 
 > `static` **getOwnPropertyNames**(`o`): `string`[]
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:182
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:182
 
 Returns the names of the own properties of an object. The own properties of an object are those that are defined directly
 on that object, and are not inherited from the object's prototype. The properties of an object include both fields (objects) and functions.
@@ -1942,7 +2294,7 @@ Object that contains the own properties.
 
 > `static` **getOwnPropertySymbols**(`o`): `symbol`[]
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es2015.core.d.ts:319
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es2015.core.d.ts:319
 
 Returns an array of all symbol properties found directly on object o.
 
@@ -1968,7 +2320,7 @@ Object to retrieve the symbols from.
 
 > `static` **getProperties**(): `PropDescriptors`
 
-Defined in: node\_modules/.pnpm/property-manager@2.0.0/node\_modules/property-manager/lib/advance.d.ts:10
+Defined in: [property-manager.js/src/advance.d.ts:10](https://github.com/snowyu/property-manager.js/blob/e9ebf4c62be9b6d84e5868ed098df041a53bb90a/src/advance.d.ts#L10)
 
 get all properties descriptor include inherited.
 
@@ -1986,7 +2338,7 @@ get all properties descriptor include inherited.
 
 > `static` **getPrototypeOf**(`o`): `any`
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:167
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:167
 
 Returns the prototype of an object.
 
@@ -2012,7 +2364,9 @@ The object that references the prototype.
 
 > `static` **hasAsyncFeature**(`feature`): `boolean`
 
-Defined in: [packages/ai-tool/src/tool-func.ts:111](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L111)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:388](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L388)
+
+Checks if any registered function has a specific asynchronous feature.
 
 #### Parameters
 
@@ -2020,10 +2374,14 @@ Defined in: [packages/ai-tool/src/tool-func.ts:111](https://github.com/isdk/ai-t
 
 [`AsyncFeatureBits`](../enumerations/AsyncFeatureBits.md)
 
+The async feature bit to check for.
+
 #### Returns
 
 `boolean`
 
+`true` if the feature is present in any function, otherwise `false`.
+
 #### Inherited from
 
 [`ToolFunc`](ToolFunc.md).[`hasAsyncFeature`](ToolFunc.md#hasasyncfeature-2)
@@ -2034,7 +2392,7 @@ Defined in: [packages/ai-tool/src/tool-func.ts:111](https://github.com/isdk/ai-t
 
 > `static` **hasOwn**(`o`, `v`): `boolean`
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es2022.object.d.ts:25
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es2022.object.d.ts:25
 
 Determines whether an object has a property with the specified name.
 
@@ -2066,7 +2424,7 @@ A property name.
 
 > `static` **is**(`value1`, `value2`): `boolean`
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es2015.core.d.ts:332
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es2015.core.d.ts:332
 
 Returns true if the values are the same value, false otherwise.
 
@@ -2098,7 +2456,7 @@ The second value.
 
 > `static` **isExtensible**(`o`): `boolean`
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:258
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:258
 
 Returns a value that indicates whether new properties can be added to an object.
 
@@ -2124,7 +2482,7 @@ Object to test.
 
 > `static` **isFrozen**(`o`): `boolean`
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:252
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:252
 
 Returns true if existing property attributes and values cannot be modified in an object, and new properties cannot be added to the object.
 
@@ -2150,7 +2508,7 @@ Object to test.
 
 > `static` **isSealed**(`o`): `boolean`
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:246
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:246
 
 Returns true if existing property attributes cannot be modified in an object and new properties cannot be added to the object.
 
@@ -2178,7 +2536,7 @@ Object to test.
 
 > `static` **keys**(`o`): `string`[]
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:264
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:264
 
 Returns the names of the enumerable string properties and methods of an object.
 
@@ -2202,7 +2560,7 @@ Object that contains the properties and methods. This can be an object that you
 
 > `static` **keys**(`o`): `string`[]
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es2015.core.d.ts:325
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es2015.core.d.ts:325
 
 Returns the names of the enumerable string properties and methods of an object.
 
@@ -2226,12 +2584,16 @@ Object that contains the properties and methods. This can be an object that you
 
 > `static` **list**(): [`Funcs`](../interfaces/Funcs.md)
 
-Defined in: [packages/ai-tool/src/tool-func.ts:69](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L69)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:331](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L331)
+
+Returns the complete map of all registered functions.
 
 #### Returns
 
 [`Funcs`](../interfaces/Funcs.md)
 
+The map of `ToolFunc` instances.
+
 #### Inherited from
 
 [`ToolFunc`](ToolFunc.md).[`list`](ToolFunc.md#list)
@@ -2242,7 +2604,7 @@ Defined in: [packages/ai-tool/src/tool-func.ts:69](https://github.com/isdk/ai-to
 
 > `static` **preventExtensions**\<`T`\>(`o`): `T`
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:240
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:240
 
 Prevents the addition of new properties to an object.
 
@@ -2274,7 +2636,9 @@ Object to make non-extensible.
 
 > `static` **register**(`name`, `options`): `boolean` \| [`ToolFunc`](ToolFunc.md)
 
-Defined in: [packages/ai-tool/src/tool-func.ts:160](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L160)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:495](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L495)
+
+Registers a new tool function.
 
 ##### Parameters
 
@@ -2282,14 +2646,24 @@ Defined in: [packages/ai-tool/src/tool-func.ts:160](https://github.com/isdk/ai-t
 
 `string`
 
+The name of the function.
+
 ###### options
 
 [`FuncItem`](../interfaces/FuncItem.md)
 
+The function's configuration.
+
 ##### Returns
 
 `boolean` \| [`ToolFunc`](ToolFunc.md)
 
+The new `ToolFunc` instance, or `false` if a function with that name already exists.
+
+The new `ToolFunc` instance, or `false` if a function with that name already exists.
+
+The new `ToolFunc` instance, or `false` if a function with that name already exists.
+
 ##### Inherited from
 
 [`ToolFunc`](ToolFunc.md).[`register`](ToolFunc.md#register-2)
@@ -2298,7 +2672,9 @@ Defined in: [packages/ai-tool/src/tool-func.ts:160](https://github.com/isdk/ai-t
 
 > `static` **register**(`func`, `options`): `boolean` \| [`ToolFunc`](ToolFunc.md)
 
-Defined in: [packages/ai-tool/src/tool-func.ts:161](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L161)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:496](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L496)
+
+Registers a new tool function.
 
 ##### Parameters
 
@@ -2306,14 +2682,24 @@ Defined in: [packages/ai-tool/src/tool-func.ts:161](https://github.com/isdk/ai-t
 
 `Function`
 
+The function implementation.
+
 ###### options
 
 [`FuncItem`](../interfaces/FuncItem.md)
 
+The function's configuration.
+
 ##### Returns
 
 `boolean` \| [`ToolFunc`](ToolFunc.md)
 
+The new `ToolFunc` instance, or `false` if a function with that name already exists.
+
+The new `ToolFunc` instance, or `false` if a function with that name already exists.
+
+The new `ToolFunc` instance, or `false` if a function with that name already exists.
+
 ##### Inherited from
 
 [`ToolFunc`](ToolFunc.md).[`register`](ToolFunc.md#register-2)
@@ -2322,22 +2708,34 @@ Defined in: [packages/ai-tool/src/tool-func.ts:161](https://github.com/isdk/ai-t
 
 > `static` **register**(`name`, `options`?): `boolean` \| [`ToolFunc`](ToolFunc.md)
 
-Defined in: [packages/ai-tool/src/tool-func.ts:162](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L162)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:497](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L497)
+
+Registers a new tool function.
 
 ##### Parameters
 
 ###### name
 
+The name of the function.
+
 `string` | `Function` | [`ToolFunc`](ToolFunc.md) | [`FuncItem`](../interfaces/FuncItem.md)
 
 ###### options?
 
 [`FuncItem`](../interfaces/FuncItem.md)
 
+The function's configuration.
+
 ##### Returns
 
 `boolean` \| [`ToolFunc`](ToolFunc.md)
 
+The new `ToolFunc` instance, or `false` if a function with that name already exists.
+
+The new `ToolFunc` instance, or `false` if a function with that name already exists.
+
+The new `ToolFunc` instance, or `false` if a function with that name already exists.
+
 ##### Inherited from
 
 [`ToolFunc`](ToolFunc.md).[`register`](ToolFunc.md#register-2)
@@ -2348,7 +2746,9 @@ Defined in: [packages/ai-tool/src/tool-func.ts:162](https://github.com/isdk/ai-t
 
 > `static` **run**(`name`, `params`?): `Promise`\<`any`\>
 
-Defined in: [packages/ai-tool/src/tool-func.ts:118](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L118)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:402](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L402)
+
+Asynchronously executes a registered function by name with named parameters.
 
 #### Parameters
 
@@ -2356,14 +2756,24 @@ Defined in: [packages/ai-tool/src/tool-func.ts:118](https://github.com/isdk/ai-t
 
 `string`
 
+The name of the function to run.
+
 ##### params?
 
 `any`
 
+The parameters object for the function.
+
 #### Returns
 
 `Promise`\<`any`\>
 
+A promise that resolves with the function's result.
+
+#### Throws
+
+If the function with the given name is not found.
+
 #### Inherited from
 
 [`ToolFunc`](ToolFunc.md).[`run`](ToolFunc.md#run-2)
@@ -2374,7 +2784,9 @@ Defined in: [packages/ai-tool/src/tool-func.ts:118](https://github.com/isdk/ai-t
 
 > `static` **runSync**(`name`, `params`?): `any`
 
-Defined in: [packages/ai-tool/src/tool-func.ts:126](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L126)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:417](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L417)
+
+Synchronously executes a registered function by name with named parameters.
 
 #### Parameters
 
@@ -2382,14 +2794,24 @@ Defined in: [packages/ai-tool/src/tool-func.ts:126](https://github.com/isdk/ai-t
 
 `string`
 
+The name of the function to run.
+
 ##### params?
 
 `any`
 
+The parameters object for the function.
+
 #### Returns
 
 `any`
 
+The result of the function's execution.
+
+#### Throws
+
+If the function with the given name is not found.
+
 #### Inherited from
 
 [`ToolFunc`](ToolFunc.md).[`runSync`](ToolFunc.md#runsync-2)
@@ -2400,7 +2822,9 @@ Defined in: [packages/ai-tool/src/tool-func.ts:126](https://github.com/isdk/ai-t
 
 > `static` **runWithPos**(`name`, ...`params`): `Promise`\<`any`\>
 
-Defined in: [packages/ai-tool/src/tool-func.ts:139](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L139)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:443](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L443)
+
+Asynchronously executes a function using positional arguments.
 
 #### Parameters
 
@@ -2408,14 +2832,24 @@ Defined in: [packages/ai-tool/src/tool-func.ts:139](https://github.com/isdk/ai-t
 
 `string`
 
+The name of the function to run.
+
 ##### params
 
 ...`any`[]
 
+Positional arguments to pass to the function.
+
 #### Returns
 
 `Promise`\<`any`\>
 
+A promise that resolves with the function's result.
+
+#### Throws
+
+If the function with the given name is not found.
+
 #### Inherited from
 
 [`ToolFunc`](ToolFunc.md).[`runWithPos`](ToolFunc.md#runwithpos-2)
@@ -2426,7 +2860,9 @@ Defined in: [packages/ai-tool/src/tool-func.ts:139](https://github.com/isdk/ai-t
 
 > `static` **runWithPosSync**(`name`, ...`params`): `any`
 
-Defined in: [packages/ai-tool/src/tool-func.ts:147](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L147)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:458](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L458)
+
+Synchronously executes a function using positional arguments.
 
 #### Parameters
 
@@ -2434,14 +2870,24 @@ Defined in: [packages/ai-tool/src/tool-func.ts:147](https://github.com/isdk/ai-t
 
 `string`
 
+The name of the function to run.
+
 ##### params
 
 ...`any`[]
 
+Positional arguments to pass to the function.
+
 #### Returns
 
 `any`
 
+The result of the function's execution.
+
+#### Throws
+
+If the function with the given name is not found.
+
 #### Inherited from
 
 [`ToolFunc`](ToolFunc.md).[`runWithPosSync`](ToolFunc.md#runwithpossync-2)
@@ -2452,7 +2898,7 @@ Defined in: [packages/ai-tool/src/tool-func.ts:147](https://github.com/isdk/ai-t
 
 > `static` **seal**\<`T`\>(`o`): `T`
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:216
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:216
 
 Prevents the modification of attributes of existing properties, and prevents the addition of new properties.
 
@@ -2482,7 +2928,7 @@ Object on which to lock the attributes.
 
 > `static` **setPrototypeOf**(`o`, `proto`): `any`
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es2015.core.d.ts:339
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es2015.core.d.ts:339
 
 Sets the prototype of a specified object o to object proto or null. Returns the object o.
 
@@ -2514,7 +2960,9 @@ The value of the new prototype or null.
 
 > `static` **unregister**(`name`): `undefined` \| [`ToolFunc`](ToolFunc.md)
 
-Defined in: [packages/ai-tool/src/tool-func.ts:207](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/tool-func.ts#L207)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:547](https://github.com/isdk/ai-tool.js/blob/209a87173b5eabb2f81db6ea9a6784f34c24e271/src/tool-func.ts#L547)
+
+Unregisters a function by its name, also removing any associated aliases.
 
 #### Parameters
 
@@ -2522,10 +2970,14 @@ Defined in: [packages/ai-tool/src/tool-func.ts:207](https://github.com/isdk/ai-t
 
 `string`
 
+The name of the function to unregister.
+
 #### Returns
 
 `undefined` \| [`ToolFunc`](ToolFunc.md)
 
+The unregistered `ToolFunc` instance, or `undefined` if it was not found.
+
 #### Inherited from
 
 [`ToolFunc`](ToolFunc.md).[`unregister`](ToolFunc.md#unregister-2)
@@ -2538,7 +2990,7 @@ Defined in: [packages/ai-tool/src/tool-func.ts:207](https://github.com/isdk/ai-t
 
 > `static` **values**\<`T`\>(`o`): `T`[]
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es2017.object.d.ts:24
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es2017.object.d.ts:24
 
 Returns an array of values of the enumerable own properties of an object
 
@@ -2566,7 +3018,7 @@ Object that contains the properties and methods. This can be an object that you
 
 > `static` **values**(`o`): `any`[]
 
-Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es2017.object.d.ts:30
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es2017.object.d.ts:30
 
 Returns an array of values of the enumerable own properties of an object