@isdk/ai-tool 0.8.2 → 0.9.0

package/docs/api/classes/EventClient.md

@@ -6,7 +6,7 @@
 
 # Class: EventClient
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event-client.ts:14](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/funcs/event-client.ts#L14)
+Defined in: @isdk/ai-tools/packages/tool-event/dist/index.d.ts:160
 
 Represents a client-side proxy for a remote tool function.
 
@@ -31,10 +31,13 @@ These tools are typically created dynamically by loading definitions from a serv
 
 > **new EventClient**(`name`, `options?`): `EventClient`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:571](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L571)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:751
 
 Initializes a new `ToolFunc` instance.
 
+If a named function is provided as the first argument (or in `options.func`),
+and no name is explicitly provided, the instance will automatically inherit the function's name.
+
 #### Parameters
 
 ##### name
@@ -45,7 +48,7 @@ Can be a function name, a function implementation, or a configuration object.
 
 ##### options?
 
-`any` = `{}`
+`any`
 
 Configuration options if not provided in the first argument.
 
@@ -63,31 +66,47 @@ Configuration options if not provided in the first argument.
 
 > **\_forwardEvents**: `Set`\<`string`\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event-client.ts:33](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/funcs/event-client.ts#L33)
+Defined in: @isdk/ai-tools/packages/tool-event/dist/index.d.ts:167
+
+***
+
+### \_registry?
+
+> `optional` **\_registry**: *typeof* [`ToolFunc`](ToolFunc.md)
+
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:496
+
+**`Internal`**
+
+The registry class where this tool was originally registered.
+
+#### Inherited from
+
+[`ResClientTools`](ResClientTools.md).[`_registry`](ResClientTools.md#_registry)
 
 ***
 
 ### \_sseListeners
 
-> **\_sseListeners**: `Record`\<`string`, (`data`, `ctx?`) => `void`\> = `{}`
+> **\_sseListeners**: `Record`\<`string`, (`data`, `ctx?`) => `void`\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event-client.ts:32](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/funcs/event-client.ts#L32)
+Defined in: @isdk/ai-tools/packages/tool-event/dist/index.d.ts:166
 
 ***
 
 ### \_stream
 
-> **\_stream**: `undefined` \| [`PubSubClientStream`](../interfaces/PubSubClientStream.md)
+> **\_stream**: [`PubSubClientStream`](../interfaces/PubSubClientStream.md) \| `undefined`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event-client.ts:29](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/funcs/event-client.ts#L29)
+Defined in: @isdk/ai-tools/packages/tool-event/dist/index.d.ts:164
 
 ***
 
 ### \_streamEvents
 
-> **\_streamEvents**: `undefined` \| `string`[]
+> **\_streamEvents**: `string`[] \| `undefined`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event-client.ts:30](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/funcs/event-client.ts#L30)
+Defined in: @isdk/ai-tools/packages/tool-event/dist/index.d.ts:165
 
 ***
 
@@ -107,7 +126,7 @@ Defined in: [property-manager.js/src/advance.d.ts:5](https://github.com/snowyu/p
 
 > `optional` **action**: `"get"` \| `"post"` \| `"put"` \| `"delete"` \| `"patch"` \| `"list"` \| `"res"`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/consts.ts:95](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/consts.ts#L95)
+Defined in: @isdk/ai-tools/packages/tool-rpc/dist/index-359784IS.d.ts:82
 
 The action to be used for the remote call. This typically represents an RPC method name.
 Only for RESTful HTTP transports, it might be mapped to a standard HTTP method (e.g., GET, POST)
@@ -122,7 +141,7 @@ Only for RESTful HTTP transports, it might be mapped to a standard HTTP method (
 
 > `optional` **alias**: `string` \| `string`[]
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:130](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L130)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:258
 
 Optional aliases for the function name.
 
@@ -136,7 +155,7 @@ Optional aliases for the function name.
 
 > `optional` **asyncFeatures**: `number`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:144](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L144)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:272
 
 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.
@@ -176,6 +195,21 @@ The initial value of Object.prototype.constructor is the standard built-in Objec
 
 ***
 
+### ctx?
+
+> `optional` **ctx**: [`ToolFuncContext`](../interfaces/ToolFuncContext.md)
+
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:547
+
+The execution context for the current function call.
+Only available when isolated execution is enabled.
+
+#### Inherited from
+
+[`ResClientTools`](ResClientTools.md).[`ctx`](ResClientTools.md#ctx)
+
+***
+
 ### defaultOptions
 
 > **defaultOptions**: `object`
@@ -202,7 +236,7 @@ The default options for export and assign
 
 > `optional` **depends**: `object`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:167](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L167)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:295
 
 A map of dependencies this function has on other tool functions.
 Declaring dependencies ensures that they are automatically registered when this function is registered.
@@ -239,9 +273,9 @@ mainFunc.register();
 
 ### description
 
-> **description**: `string` = `'subscribe server event'`
+> **description**: `string`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event-client.ts:61](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/funcs/event-client.ts#L61)
+Defined in: @isdk/ai-tools/packages/tool-event/dist/index.d.ts:172
 
 A detailed description of what the function does.
 
@@ -255,7 +289,7 @@ A detailed description of what the function does.
 
 > **ebListener**: (`this`, ...`args`) => `Promise`\<`void`\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event-client.ts:101](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/funcs/event-client.ts#L101)
+Defined in: @isdk/ai-tools/packages/tool-event/dist/index.d.ts:175
 
 #### Parameters
 
@@ -273,11 +307,25 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event-client.ts:101](http
 
 ***
 
+### expectedDuration?
+
+> `optional` **expectedDuration**: `number`
+
+Defined in: @isdk/ai-tools/packages/tool-rpc/dist/index-359784IS.d.ts:102
+
+The expected duration of the remote call in milliseconds.
+
+#### Inherited from
+
+[`ResClientTools`](ResClientTools.md).[`expectedDuration`](ResClientTools.md#expectedduration)
+
+***
+
 ### fetchOptions?
 
 > `optional` **fetchOptions**: `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/consts.ts:100](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/consts.ts#L100)
+Defined in: @isdk/ai-tools/packages/tool-rpc/dist/index-359784IS.d.ts:87
 
 Addtional options to be passed to the underlying `fetch` call in a transport.
 
@@ -291,7 +339,7 @@ Addtional options to be passed to the underlying `fetch` call in a transport.
 
 > `optional` **isApi**: `boolean`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:119](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L119)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:247
 
 If true, indicates that this function should be treated as a server-side API.
 
@@ -305,7 +353,7 @@ If true, indicates that this function should be treated as a server-side API.
 
 > `optional` **name**: `string`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:76](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L76)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:204
 
 The unique name of the function.
 
@@ -333,7 +381,7 @@ the property with the default prefix '$' will not be exported.
 
 > `optional` **params**: [`FuncParams`](../interfaces/FuncParams.md) \| [`FuncParam`](../interfaces/FuncParam.md)[]
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:81](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L81)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:209
 
 Parameter definitions, which can be an object mapping names to definitions or an array for positional parameters.
 
@@ -347,7 +395,7 @@ Parameter definitions, which can be an object mapping names to definitions or an
 
 > `optional` **result**: `string` \| `Record`\<`string`, `any`\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:86](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L86)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:214
 
 The expected return type of the function, described as a string or a JSON schema object.
 
@@ -361,7 +409,7 @@ The expected return type of the function, described as a string or a JSON schema
 
 > `optional` **scope**: `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:91](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L91)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:219
 
 The execution scope or context (`this`) for the function.
 
@@ -375,7 +423,7 @@ The execution scope or context (`this`) for the function.
 
 > `optional` **setup**: (`this`, `options?`) => `void`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:114](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L114)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:242
 
 A lifecycle hook called once during the `ToolFunc` instance's initialization.
 It allows for initial setup, state configuration, or property modification on the instance
@@ -421,7 +469,7 @@ console.log(myFunc.customState); // Outputs: 'configured'
 
 > `optional` **stream**: `boolean`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:125](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L125)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:253
 
 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.
@@ -436,7 +484,7 @@ Whether a specific call is streamed is determined by a `stream` property in the
 
 > `optional` **tags**: `string` \| `string`[]
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:96](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L96)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:224
 
 Tags for grouping or filtering functions.
 
@@ -446,11 +494,49 @@ Tags for grouping or filtering functions.
 
 ***
 
+### timeout?
+
+> `optional` **timeout**: `number` \| \{ `keepAliveOnTimeout?`: `boolean`; `streamIdleTimeout?`: `number`; `value`: `number`; \}
+
+Defined in: @isdk/ai-tools/packages/tool-rpc/dist/index-359784IS.d.ts:91
+
+The timeout configuration for the remote call.
+
+#### Type Declaration
+
+`number`
+
+\{ `keepAliveOnTimeout?`: `boolean`; `streamIdleTimeout?`: `number`; `value`: `number`; \}
+
+#### keepAliveOnTimeout?
+
+> `optional` **keepAliveOnTimeout**: `boolean`
+
+Whether to keep the server-side function running after a timeout.
+
+#### streamIdleTimeout?
+
+> `optional` **streamIdleTimeout**: `number`
+
+The idle timeout for streaming responses in milliseconds.
+
+#### value
+
+> **value**: `number`
+
+The hard timeout in milliseconds.
+
+#### Inherited from
+
+[`ResClientTools`](ResClientTools.md).[`timeout`](ResClientTools.md#timeout)
+
+***
+
 ### 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/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L177)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:307
 
 A concise, human-readable title for the function, often used in UI or by AI.
 
@@ -462,9 +548,28 @@ A concise, human-readable title for the function, often used in UI or by AI.
 
 ### \_pubSubTransport
 
-> `static` **\_pubSubTransport**: `undefined` \| [`IPubSubClientTransport`](../interfaces/IPubSubClientTransport.md)
+> `static` **\_pubSubTransport**: [`IPubSubClientTransport`](../interfaces/IPubSubClientTransport.md) \| `undefined`
+
+Defined in: @isdk/ai-tools/packages/tool-event/dist/index.d.ts:161
+
+***
+
+### \_refCounts
+
+> `protected` `static` **\_refCounts**: `object`
+
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:489
+
+Tracks the number of active registration holds on each function name.
+A function is truly removed only when its reference count drops to zero.
+
+#### Index Signature
+
+\[`name`: `string`\]: `number`
+
+#### Inherited from
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event-client.ts:15](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/funcs/event-client.ts#L15)
+[`ResClientTools`](ResClientTools.md).[`_refCounts`](ResClientTools.md#_refcounts)
 
 ***
 
@@ -472,7 +577,7 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event-client.ts:15](https
 
 > `static` `optional` **action**: `string`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/client-tools.ts:33](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/client-tools.ts#L33)
+Defined in: @isdk/ai-tools/packages/tool-rpc/dist/index-359784IS.d.ts:215
 
 #### Inherited from
 
@@ -482,11 +587,11 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/client-tools.ts:33](https://git
 
 ### aliases
 
-> `static` **aliases**: `object` = `{}`
+> `static` **aliases**: `object`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:305](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L305)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:480
 
-A static map of aliases to their corresponding function names.
+A static map of aliases to their corresponding primary function names.
 
 #### Index Signature
 
@@ -498,11 +603,25 @@ A static map of aliases to their corresponding function names.
 
 ***
 
+### ctx?
+
+> `static` `optional` **ctx**: [`ToolFuncContext`](../interfaces/ToolFuncContext.md)
+
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:508
+
+The static execution context for proxy classes created via ToolFunc.with().
+
+#### Inherited from
+
+[`ResClientTools`](ResClientTools.md).[`ctx`](ResClientTools.md#ctx-1)
+
+***
+
 ### dataPath
 
 > `static` **dataPath**: `string`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:312](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L312)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:503
 
 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
@@ -516,11 +635,11 @@ developer to use this path to save and load the `ToolFunc.items` registry if nee
 
 ### items
 
-> `static` **items**: [`Funcs`](../interfaces/Funcs.md) = `{}`
+> `static` **items**: [`Funcs`](../interfaces/Funcs.md)
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:300](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L300)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:475
 
-A static registry of all `ToolFunc` instances, indexed by name.
+A static registry of all `ToolFunc` implementations, indexed by their primary name.
 
 #### Inherited from
 
@@ -534,7 +653,7 @@ A static registry of all `ToolFunc` instances, indexed by name.
 
 > **get** **active**(): `boolean`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event-client.ts:47](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/funcs/event-client.ts#L47)
+Defined in: @isdk/ai-tools/packages/tool-event/dist/index.d.ts:170
 
 ##### Returns
 
@@ -548,7 +667,7 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event-client.ts:47](https
 
 > **get** **apiRoot**(): `string`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/client-tools.ts:110](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/client-tools.ts#L110)
+Defined in: @isdk/ai-tools/packages/tool-rpc/dist/index-359784IS.d.ts:247
 
 Gets the root URL for API endpoints from the configured transport.
 This is used as the base for constructing request URLs.
@@ -573,13 +692,13 @@ Use `transport` instead.
 
 #### Get Signature
 
-> **get** **clientId**(): `undefined` \| `string`
+> **get** **clientId**(): `string` \| `undefined`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event-client.ts:35](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/funcs/event-client.ts#L35)
+Defined in: @isdk/ai-tools/packages/tool-event/dist/index.d.ts:168
 
 ##### Returns
 
-`undefined` \| `string`
+`string` \| `undefined`
 
 ***
 
@@ -589,7 +708,7 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event-client.ts:35](https
 
 > **get** `static` **apiRoot**(): `string`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/client-tools.ts:41](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/client-tools.ts#L41)
+Defined in: @isdk/ai-tools/packages/tool-rpc/dist/index-359784IS.d.ts:221
 
 Gets the root URL for API endpoints from the configured transport.
 This is used as the base for constructing request URLs.
@@ -610,7 +729,7 @@ This is used as the base for constructing request URLs.
 
 > **get** `static` **pubSubTransport**(): [`IPubSubClientTransport`](../interfaces/IPubSubClientTransport.md)
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event-client.ts:24](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/funcs/event-client.ts#L24)
+Defined in: @isdk/ai-tools/packages/tool-event/dist/index.d.ts:163
 
 ##### Returns
 
@@ -624,7 +743,7 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event-client.ts:24](https
 
 > **get** `static` **transport**(): [`IClientToolTransport`](../interfaces/IClientToolTransport.md)
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/client-tools.ts:61](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/client-tools.ts#L61)
+Defined in: @isdk/ai-tools/packages/tool-rpc/dist/index-359784IS.d.ts:228
 
 ##### Returns
 
@@ -640,7 +759,7 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/client-tools.ts:61](https://git
 
 > **\_func**(`action`, `options`, `fetchOptions?`): `Promise`\<`any`\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/rpc-methods-client-tool.ts:19](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/rpc-methods-client-tool.ts#L19)
+Defined in: @isdk/ai-tools/packages/tool-rpc/dist/index.d.ts:14
 
 #### Parameters
 
@@ -666,11 +785,78 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/rpc-methods-client-tool.ts:19](
 
 ***
 
+### \_prepareContext()
+
+> `protected` **\_prepareContext**(`params?`, `ctx?`): [`ToolFuncContext`](../interfaces/ToolFuncContext.md)
+
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:806
+
+Creates the final execution context (`this.ctx`) for a Shadow Instance.
+
+NOTE: We MUST use 'this._prepareContext' (instance path) instead of
+'Static._prepareContext' to allow AOP plugins (like CancelableAbility)
+to hook into context preparation via method overloading ($_prepareContext).
+
+#### Parameters
+
+##### params?
+
+`any`
+
+##### ctx?
+
+[`ToolFuncContext`](../interfaces/ToolFuncContext.md)
+
+#### Returns
+
+[`ToolFuncContext`](../interfaces/ToolFuncContext.md)
+
+#### Inherited from
+
+[`ResClientTools`](ResClientTools.md).[`_prepareContext`](ResClientTools.md#_preparecontext)
+
+***
+
+### \_shouldIsolate()
+
+> `protected` **\_shouldIsolate**(`params?`, `ctx?`): `boolean`
+
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:798
+
+Determines if the function execution should be isolated into a "Shadow Instance".
+
+PRIORITY LOGIC:
+1. Explicit 'ctx.isolated' in the current call (Highest).
+2. Any explicit 'ctx' provided (Safe default: isolate to apply new overrides).
+3. Prevention of recursion (If already an own 'ctx' property exists).
+4. Inherited 'this.ctx.isolated' configuration.
+5. Presence of any inherited context (Default: isolate for concurrency safety).
+
+#### Parameters
+
+##### params?
+
+`any`
+
+##### ctx?
+
+[`ToolFuncContext`](../interfaces/ToolFuncContext.md)
+
+#### Returns
+
+`boolean`
+
+#### Inherited from
+
+[`ResClientTools`](ResClientTools.md).[`_shouldIsolate`](ResClientTools.md#_shouldisolate)
+
+***
+
 ### arr2ObjParams()
 
 > **arr2ObjParams**(`params`): `any`[]
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:629](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L629)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:770
 
 Converts an array of positional arguments into a named parameters object.
 This is used internally to support functions defined with named parameters.
@@ -731,7 +917,7 @@ this object
 
 > **assignMethods**(`methods`): `void`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/rpc-methods-client-tool.ts:32](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/rpc-methods-client-tool.ts#L32)
+Defined in: @isdk/ai-tools/packages/tool-rpc/dist/index.d.ts:16
 
 #### Parameters
 
@@ -945,7 +1131,7 @@ the new dest object
 
 > **close**(): `void`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event-client.ts:211](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/funcs/event-client.ts#L211)
+Defined in: @isdk/ai-tools/packages/tool-event/dist/index.d.ts:205
 
 #### Returns
 
@@ -983,7 +1169,7 @@ the defined attributes of the object
 
 > `optional` **delete**(`__namedParameters`): `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/res-client-tools.ts:13](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/res-client-tools.ts#L13)
+Defined in: @isdk/ai-tools/packages/tool-rpc/dist/index.d.ts:58
 
 #### Parameters
 
@@ -1005,7 +1191,7 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/res-client-tools.ts:13](https:/
 
 > **esListener**(`evtType`, `data`, `ctx?`): `void`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event-client.ts:90](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/funcs/event-client.ts#L90)
+Defined in: @isdk/ai-tools/packages/tool-event/dist/index.d.ts:174
 
 #### Parameters
 
@@ -1063,7 +1249,7 @@ the dest object.
 
 > **fetch**(`options`, `action`, ...`args`): `Promise`\<`any`\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/res-client-tools.ts:18](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/res-client-tools.ts#L18)
+Defined in: @isdk/ai-tools/packages/tool-rpc/dist/index.d.ts:62
 
 #### Parameters
 
@@ -1093,7 +1279,7 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/res-client-tools.ts:18](https:/
 
 > **forwardEvent**(`events`): `void`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event-client.ts:172](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/funcs/event-client.ts#L172)
+Defined in: @isdk/ai-tools/packages/tool-event/dist/index.d.ts:194
 
 forward local event(s) to server
 
@@ -1117,7 +1303,7 @@ Note: pls backendEventable(ClientTools or EventClient) first
 
 > **func**(`options`): `Promise`\<`any`\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/rpc-methods-client-tool.ts:24](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/rpc-methods-client-tool.ts#L24)
+Defined in: @isdk/ai-tools/packages/tool-rpc/dist/index.d.ts:15
 
 The core implementation for a client-side tool. When a `ClientTools` instance
 is "run", this `func` method is executed. It delegates the call to the
@@ -1145,7 +1331,7 @@ The result from the remote tool.
 
 > `optional` **get**(`__namedParameters`): `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/res-client-tools.ts:10](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/res-client-tools.ts#L10)
+Defined in: @isdk/ai-tools/packages/tool-rpc/dist/index.d.ts:55
 
 #### Parameters
 
@@ -1167,7 +1353,7 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/res-client-tools.ts:10](https:/
 
 > **getEvtSource**(): `Promise`\<[`PubSubClientStream`](../interfaces/PubSubClientStream.md)\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event-client.ts:39](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/funcs/event-client.ts#L39)
+Defined in: @isdk/ai-tools/packages/tool-event/dist/index.d.ts:169
 
 #### Returns
 
@@ -1179,7 +1365,7 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event-client.ts:39](https
 
 > **getFunc**(`name?`): `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:720](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L720)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:866
 
 Gets a bound function reference for execution with named parameters.
 If a name is provided, it retrieves a different function from the registry.
@@ -1209,7 +1395,7 @@ A function reference or `undefined` if not found.
 
 > **getFuncWithPos**(`name?`): `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:777](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L777)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:910
 
 Gets a bound function reference suitable for positional argument execution.
 If a name is provided, it retrieves a different function from the registry.
@@ -1259,7 +1445,7 @@ the descriptors of properties object
 
 > **hasAsyncFeature**(`feature`): `boolean`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:787](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L787)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:916
 
 Checks if the current function instance supports a specific async feature.
 
@@ -1313,7 +1499,7 @@ A property name.
 
 > **init**(`events`): `Promise`\<`any`\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event-client.ts:204](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/funcs/event-client.ts#L204)
+Defined in: @isdk/ai-tools/packages/tool-event/dist/index.d.ts:204
 
 #### Parameters
 
@@ -1331,7 +1517,7 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event-client.ts:204](http
 
 > **initEventStream**(`events?`): `Promise`\<[`PubSubClientStream`](../interfaces/PubSubClientStream.md)\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event-client.ts:63](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/funcs/event-client.ts#L63)
+Defined in: @isdk/ai-tools/packages/tool-event/dist/index.d.ts:173
 
 #### Parameters
 
@@ -1429,9 +1615,9 @@ The source object
 
 ### isStream()
 
-> **isStream**(`params`): `undefined` \| `boolean`
+> **isStream**(`params`): `boolean` \| `undefined`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:805](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L805)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:929
 
 Determines if a function call should produce a stream.
 
@@ -1451,7 +1637,7 @@ The runtime parameters passed to the function call.
 
 #### Returns
 
-`undefined` \| `boolean`
+`boolean` \| `undefined`
 
 `true` if the call should be streamed, `false` or `undefined` otherwise.
 
@@ -1465,7 +1651,7 @@ The runtime parameters passed to the function call.
 
 > `optional` **list**(`options?`): `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/res-client-tools.ts:14](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/res-client-tools.ts#L14)
+Defined in: @isdk/ai-tools/packages/tool-rpc/dist/index.d.ts:59
 
 #### Parameters
 
@@ -1519,7 +1705,7 @@ the dest object.
 
 > **obj2ArrParams**(`params?`): `any`[]
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:648](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L648)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:777
 
 Converts a named parameters object into an array of positional arguments.
 This is used for functions defined with positional parameters.
@@ -1548,7 +1734,7 @@ An array of positional arguments.
 
 > `optional` **post**(`options`): `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/res-client-tools.ts:11](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/res-client-tools.ts#L11)
+Defined in: @isdk/ai-tools/packages/tool-rpc/dist/index.d.ts:56
 
 #### Parameters
 
@@ -1596,7 +1782,7 @@ A property name.
 
 > `optional` **put**(`__namedParameters`): `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/res-client-tools.ts:12](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/res-client-tools.ts#L12)
+Defined in: @isdk/ai-tools/packages/tool-rpc/dist/index.d.ts:57
 
 #### Parameters
 
@@ -1618,7 +1804,7 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/res-client-tools.ts:12](https:/
 
 > **register**(): `boolean` \| [`ToolFunc`](ToolFunc.md)
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:602](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L602)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:757
 
 Registers the current `ToolFunc` instance into the static registry.
 Also registers any declared dependencies.
@@ -1637,12 +1823,15 @@ The instance itself upon successful registration, or `false` if it already exist
 
 ### run()
 
-> **run**(`params?`): `Promise`\<`any`\>
+> **run**(`params?`, `ctx?`): `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:686](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L686)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:825
 
 Executes the function asynchronously with a named parameters object.
 
+Note: This method returns a `Promise` if the underlying function is asynchronous,
+otherwise it may return the result synchronously.
+
 #### Parameters
 
 ##### params?
@@ -1651,11 +1840,17 @@ Executes the function asynchronously with a named parameters object.
 
 The parameters object for the function.
 
+##### ctx?
+
+[`ToolFuncContext`](../interfaces/ToolFuncContext.md)
+
+The execution context.
+
 #### Returns
 
-`Promise`\<`any`\>
+`any`
 
-A promise that resolves with the function's result.
+A promise or the direct result of the function's execution.
 
 #### Inherited from
 
@@ -1665,12 +1860,14 @@ A promise that resolves with the function's result.
 
 ### runAs()
 
-> **runAs**(`name`, `params?`): `Promise`\<`any`\>
+> **runAs**(`name`, `params?`, `ctx?`): `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:697](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L697)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:837
 
 Asynchronously executes another registered function by name.
-This method delegates to `runAsSync()` internally.
+
+Note: This method returns a `Promise` if the underlying function is asynchronous,
+otherwise it may return the result synchronously.
 
 #### Parameters
 
@@ -1686,11 +1883,17 @@ The name of the target function to run.
 
 Optional parameters to pass to the function.
 
+##### ctx?
+
+[`ToolFuncContext`](../interfaces/ToolFuncContext.md)
+
+The execution context.
+
 #### Returns
 
-`Promise`\<`any`\>
+`any`
 
-A promise that resolves with the result of the function execution.
+A promise or the direct result of the function's execution.
 
 #### Inherited from
 
@@ -1700,12 +1903,22 @@ A promise that resolves with the result of the function execution.
 
 ### runAsSync()
 
-> **runAsSync**(`name`, `params?`): `any`
+> **runAsSync**(`name`, `params?`, `ctx?`): `any`
+
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:858
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:708](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L708)
+Executes another registered function by name, using hierarchical dependency resolution.
 
-Synchronously executes another registered function by name.
-This is a convenience method that forwards the call to the static `runSync()` method.
+This method supports **Late-Binding Polymorphism**. It uses the `rootRegistry` and
+`binding` strategy from the execution context to resolve dependencies.
+
+### Binding Modes:
+- `'auto'` (Default): **Lineage-Aware**. Uses late-binding only if the `rootRegistry`
+  is a descendant of the tool's definition registry and has shadowed the dependency.
+  Otherwise, uses early-binding for stability.
+- `'early'`: **Safety First**. Always prefers the pre-bound instance from `depends`.
+- `'late'`: **Forced Polymorphism**. Always resolves from the `rootRegistry`,
+  ignoring the definer's environment.
 
 #### Parameters
 
@@ -1713,19 +1926,29 @@ This is a convenience method that forwards the call to the static `runSync()` me
 
 `string`
 
-The name of the target function to run.
+The name or alias of the target function to run.
 
 ##### params?
 
 `any`
 
-Optional parameters to pass to the function.
+Optional parameters to pass to the target function.
+
+##### ctx?
+
+[`ToolFuncContext`](../interfaces/ToolFuncContext.md)
+
+The execution context.
 
 #### Returns
 
 `any`
 
-The result of the function execution.
+The result of the target function execution.
+
+#### Throws
+
+If the target function cannot be found in the current lineage.
 
 #### Inherited from
 
@@ -1735,9 +1958,9 @@ The result of the function execution.
 
 ### runSync()
 
-> **runSync**(`params?`): `any`
+> **runSync**(`params?`, `ctx?`): `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:667](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L667)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:814
 
 Executes the function synchronously with a named parameters object.
 
@@ -1749,6 +1972,12 @@ Executes the function synchronously with a named parameters object.
 
 The parameters object for the function.
 
+##### ctx?
+
+[`ToolFuncContext`](../interfaces/ToolFuncContext.md)
+
+The execution context.
+
 #### Returns
 
 `any`
@@ -1767,12 +1996,14 @@ Will throw an error if an array of parameters is passed to a function that expec
 
 ### runWithPos()
 
-> **runWithPos**(...`params`): `Promise`\<`any`\>
+> **runWithPos**(...`params`): `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:755](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L755)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:891
 
 Executes the function asynchronously using positional arguments.
-Delegates to `runWithPosSync()` internally.
+
+Note: This method returns a `Promise` if the underlying function is asynchronous,
+otherwise it may return the result synchronously.
 
 #### Parameters
 
@@ -1784,9 +2015,9 @@ Positional arguments passed to the function.
 
 #### Returns
 
-`Promise`\<`any`\>
+`any`
 
-A promise that resolves with the result of the function execution.
+A promise or the direct result of the function's execution.
 
 #### Inherited from
 
@@ -1796,12 +2027,14 @@ A promise that resolves with the result of the function execution.
 
 ### runWithPosAs()
 
-> **runWithPosAs**(`name`, ...`params`): `Promise`\<`any`\>
+> **runWithPosAs**(`name`, ...`params`): `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:766](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L766)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:902
 
 Asynchronously executes another function by name using positional arguments.
-Delegates to `runWithPosAsSync()` internally.
+
+Note: This method returns a `Promise` if the underlying function is asynchronous,
+otherwise it may return the result synchronously.
 
 #### Parameters
 
@@ -1819,9 +2052,9 @@ Positional arguments to pass to the function.
 
 #### Returns
 
-`Promise`\<`any`\>
+`any`
 
-A promise that resolves with the result of the function execution.
+A promise or the direct result of the function's execution.
 
 #### Inherited from
 
@@ -1833,7 +2066,7 @@ A promise that resolves with the result of the function execution.
 
 > **runWithPosAsSync**(`name`, ...`params`): `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:745](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L745)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:881
 
 Synchronously executes another function by name using positional arguments.
 This is a convenience wrapper around the static `runWithPosSync()` method.
@@ -1868,7 +2101,7 @@ The result of the function execution.
 
 > **runWithPosSync**(...`params`): `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:731](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L731)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:873
 
 Executes the function synchronously using positional arguments.
 If the function expects named parameters, it converts the arguments automatically.
@@ -1897,7 +2130,7 @@ The result of the function execution.
 
 > **setActive**(`v`): `Promise`\<`void`\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event-client.ts:51](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/funcs/event-client.ts#L51)
+Defined in: @isdk/ai-tools/packages/tool-event/dist/index.d.ts:171
 
 #### Parameters
 
@@ -1915,7 +2148,7 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event-client.ts:51](https
 
 > **subscribe**(`events`): `Promise`\<`any`\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event-client.ts:126](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/funcs/event-client.ts#L126)
+Defined in: @isdk/ai-tools/packages/tool-event/dist/index.d.ts:180
 
 subscribe server event
 
@@ -2013,7 +2246,7 @@ Returns a string representation of an object.
 
 > **unforwardEvent**(`events`): `void`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event-client.ts:192](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/funcs/event-client.ts#L192)
+Defined in: @isdk/ai-tools/packages/tool-event/dist/index.d.ts:203
 
 unforward local event(s) to server
 
@@ -2035,12 +2268,20 @@ Note: pls backendEventable(ClientTools or EventClient) first
 
 ### unregister()
 
-> **unregister**(): `any`
+> **unregister**(`options?`): `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:619](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L619)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:763
 
 Removes the current `ToolFunc` instance from the static registry.
 
+#### Parameters
+
+##### options?
+
+Unregistration options or a boolean force flag.
+
+`boolean` | [`UnregisterOptions`](../interfaces/UnregisterOptions.md)
+
 #### Returns
 
 `any`
@@ -2057,7 +2298,7 @@ The instance that was unregistered.
 
 > **unsubscribe**(`events`): `Promise`\<`any`\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event-client.ts:148](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/funcs/event-client.ts#L148)
+Defined in: @isdk/ai-tools/packages/tool-event/dist/index.d.ts:185
 
 unsubscribe server event
 
@@ -2091,6 +2332,282 @@ Returns the primitive value of the specified object.
 
 ***
 
+### with()
+
+> **with**(`ctx`): `this`
+
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:542
+
+Returns an isolated instance with the provided context.
+
+#### Parameters
+
+##### ctx
+
+[`ToolFuncContext`](../interfaces/ToolFuncContext.md)
+
+The context to use.
+
+#### Returns
+
+`this`
+
+An isolated ToolFunc instance.
+
+#### Inherited from
+
+[`ResClientTools`](ResClientTools.md).[`with`](ResClientTools.md#with)
+
+***
+
+### \_acquireDependencies()
+
+> `protected` `static` **\_acquireDependencies**(`inst`, `stack?`): `void`
+
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:740
+
+#### Parameters
+
+##### inst
+
+[`ToolFunc`](ToolFunc.md)
+
+##### stack?
+
+`Set`\<`string`\>
+
+#### Returns
+
+`void`
+
+#### Inherited from
+
+[`ResClientTools`](ResClientTools.md).[`_acquireDependencies`](ResClientTools.md#_acquiredependencies)
+
+***
+
+### \_decRefCount()
+
+> `protected` `static` **\_decRefCount**(`name`): `number`
+
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:739
+
+#### Parameters
+
+##### name
+
+`string`
+
+#### Returns
+
+`number`
+
+#### Inherited from
+
+[`ResClientTools`](ResClientTools.md).[`_decRefCount`](ResClientTools.md#_decrefcount)
+
+***
+
+### \_getRegistrationAction()
+
+> `protected` `static` **\_getRegistrationAction**(`name`, `override`): `"replace"` \| `"create"` \| `"shadow"` \| `"increment"`
+
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:670
+
+Analyzes the registration context and determines the appropriate action.
+
+#### Parameters
+
+##### name
+
+`string`
+
+The function name to register.
+
+##### override
+
+Override options.
+
+###### name?
+
+`boolean`
+
+#### Returns
+
+`"replace"` \| `"create"` \| `"shadow"` \| `"increment"`
+
+The determined registration action.
+
+#### Inherited from
+
+[`ResClientTools`](ResClientTools.md).[`_getRegistrationAction`](ResClientTools.md#_getregistrationaction)
+
+***
+
+### \_incRefCount()
+
+> `protected` `static` **\_incRefCount**(`name`): `void`
+
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:738
+
+#### Parameters
+
+##### name
+
+`string`
+
+#### Returns
+
+`void`
+
+#### Inherited from
+
+[`ResClientTools`](ResClientTools.md).[`_incRefCount`](ResClientTools.md#_increfcount)
+
+***
+
+### \_normalizeArguments()
+
+> `protected` `static` **\_normalizeArguments**(`name`, `options?`): `any`
+
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:643
+
+**`Internal`**
+
+Internal helper to normalize arguments from various input patterns.
+Priority: name (arg1) > options (arg2).
+
+#### Parameters
+
+##### name
+
+Primary config.
+
+`string` | `Function` | [`ToolFunc`](ToolFunc.md) | [`FuncItem`](../interfaces/FuncItem.md)
+
+##### options?
+
+`any`
+
+Default config.
+
+#### Returns
+
+`any`
+
+Normalized options object.
+
+#### Inherited from
+
+[`ResClientTools`](ResClientTools.md).[`_normalizeArguments`](ResClientTools.md#_normalizearguments)
+
+***
+
+### \_normalizeRegisterArguments()
+
+> `protected` `static` **\_normalizeRegisterArguments**(`name`, `options?`): [`RegisterOptions`](../interfaces/RegisterOptions.md)
+
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:682
+
+**`Internal`**
+
+Normalizes the arguments passed to the `register` method into a unified `RegisterOptions` object.
+
+#### Parameters
+
+##### name
+
+The primary identification or implementation.
+
+`string` | `Function` | [`ToolFunc`](ToolFunc.md) | [`RegisterOptions`](../interfaces/RegisterOptions.md)
+
+##### options?
+
+[`RegisterOptions`](../interfaces/RegisterOptions.md)
+
+Additional or overriding configuration.
+
+#### Returns
+
+[`RegisterOptions`](../interfaces/RegisterOptions.md)
+
+A normalized options object ready for registration.
+
+#### Inherited from
+
+[`ResClientTools`](ResClientTools.md).[`_normalizeRegisterArguments`](ResClientTools.md#_normalizeregisterarguments)
+
+***
+
+### \_prepareContext()
+
+> `static` **\_prepareContext**(`parentCtx?`, `ctx?`): [`ToolFuncContext`](../interfaces/ToolFuncContext.md)
+
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:535
+
+**`Internal`**
+
+Internal helper to prepare the execution context, maintaining the prototype chain.
+
+#### Parameters
+
+##### parentCtx?
+
+[`ToolFuncContext`](../interfaces/ToolFuncContext.md)
+
+The parent context to inherit from.
+
+##### ctx?
+
+[`ToolFuncContext`](../interfaces/ToolFuncContext.md)
+
+The new context properties to apply.
+
+#### Returns
+
+[`ToolFuncContext`](../interfaces/ToolFuncContext.md)
+
+The merged context.
+
+DANGER - DO NOT "OPTIMIZE" UNLESS YOU UNDERSTAND:
+1. Why NOT Object.assign(target, ctx) alone?
+   Object.assign only copies 'own' properties. In nested calls (e.g., .with().with()),
+   parent properties exist on the prototype. Using assign would drop all inherited
+   context data (like traceId from a parent runner).
+2. Why NOT Object.setPrototypeOf?
+   It's a heavy performance killer in V8. We use Object.create(proto) instead.
+3. Why check isPrototypeOf?
+   If ctx is already in the chain, we return it to maintain identity and avoid
+   redundant shadow layers, which is required by many AOP plugins and unit tests.
+
+#### Inherited from
+
+[`ResClientTools`](ResClientTools.md).[`_prepareContext`](ResClientTools.md#_preparecontext-2)
+
+***
+
+### \_releaseDependencies()
+
+> `protected` `static` **\_releaseDependencies**(`inst`): `void`
+
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:741
+
+#### Parameters
+
+##### inst
+
+[`ToolFunc`](ToolFunc.md)
+
+#### Returns
+
+`void`
+
+#### Inherited from
+
+[`ResClientTools`](ResClientTools.md).[`_releaseDependencies`](ResClientTools.md#_releasedependencies)
+
+***
+
 ### assign()
 
 #### Call Signature
@@ -2279,6 +2796,27 @@ One or more source objects from which to copy properties
 
 ***
 
+### clear()
+
+> `static` **clear**(): `void`
+
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:661
+
+Resets the local registry by clearing all registered items, aliases, and reference counts.
+
+In a hierarchical registry, this only clears properties "owned" by the current
+layer. Inherited items from parent registries remain visible through the prototype chain.
+
+#### Returns
+
+`void`
+
+#### Inherited from
+
+[`ResClientTools`](ResClientTools.md).[`clear`](ResClientTools.md#clear)
+
+***
+
 ### create()
 
 #### Call Signature
@@ -2295,7 +2833,7 @@ Creates an object that has the specified prototype or that has null prototype.
 
 Object to use as a prototype. May be null.
 
-`null` | `object`
+`object` | `null`
 
 ##### Returns
 
@@ -2319,7 +2857,7 @@ Creates an object that has the specified prototype, and that optionally contains
 
 Object to use as a prototype. May be null
 
-`null` | `object`
+`object` | `null`
 
 ###### properties
 
@@ -2473,7 +3011,7 @@ Object that contains the properties and methods. This can be an object that you
 
 > `static` **fetch**(`name`, `objParam?`, ...`args?`): `Promise`\<`any`\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/client-tools.ts:99](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/client-tools.ts#L99)
+Defined in: @isdk/ai-tools/packages/tool-rpc/dist/index-359784IS.d.ts:242
 
 #### Parameters
 
@@ -2655,39 +3193,11 @@ An iterable object that contains key-value entries for properties and methods.
 
 ***
 
-### get()
-
-> `static` **get**(`name`): [`ToolFunc`](ToolFunc.md)
-
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:319](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L319)
-
-Retrieves a registered function by its name or alias.
-
-#### Parameters
-
-##### name
-
-`string`
-
-The name or alias of the function to retrieve.
-
-#### Returns
-
-[`ToolFunc`](ToolFunc.md)
-
-The `ToolFunc` instance if found, otherwise `undefined`.
-
-#### Inherited from
-
-[`ResClientTools`](ResClientTools.md).[`get`](ResClientTools.md#get-2)
-
-***
-
 ### getAllByTag()
 
 > `static` **getAllByTag**(`tagName`): [`ToolFunc`](ToolFunc.md)[]
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:365](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L365)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:570
 
 Retrieves all registered functions that have a specific tag.
 
@@ -2713,9 +3223,9 @@ An array of matching `ToolFunc` instances.
 
 ### getByTag()
 
-> `static` **getByTag**(`tagName`): `undefined` \| [`ToolFunc`](ToolFunc.md)
+> `static` **getByTag**(`tagName`): [`ToolFunc`](ToolFunc.md) \| `undefined`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:340](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L340)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:564
 
 Finds the first registered function that has a specific tag.
 
@@ -2729,7 +3239,7 @@ The tag to search for.
 
 #### Returns
 
-`undefined` \| [`ToolFunc`](ToolFunc.md)
+[`ToolFunc`](ToolFunc.md) \| `undefined`
 
 The first matching `ToolFunc` instance, or `undefined` if none is found.
 
@@ -2743,7 +3253,7 @@ The first matching `ToolFunc` instance, or `undefined` if none is found.
 
 > `static` **getFunc**(`name`): `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:431](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L431)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:605
 
 Retrieves a bound, runnable function reference for a registered function.
 This reference is suitable for execution with an object of named parameters.
@@ -2772,7 +3282,7 @@ A bound function reference, or `undefined` if not found.
 
 > `static` **getFuncWithPos**(`name`): `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:472](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L472)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:632
 
 Retrieves a bound, runnable function reference for a registered function.
 This reference is suitable for execution with positional arguments.
@@ -2799,7 +3309,7 @@ A bound function reference, or `undefined` if not found.
 
 ### getOwnPropertyDescriptor()
 
-> `static` **getOwnPropertyDescriptor**(`o`, `p`): `undefined` \| `PropertyDescriptor`
+> `static` **getOwnPropertyDescriptor**(`o`, `p`): `PropertyDescriptor` \| `undefined`
 
 Defined in: @isdk/ai-tools/node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:175
 
@@ -2822,7 +3332,7 @@ Name of the property.
 
 #### Returns
 
-`undefined` \| `PropertyDescriptor`
+`PropertyDescriptor` \| `undefined`
 
 #### Inherited from
 
@@ -2963,7 +3473,7 @@ The object that references the prototype.
 
 > `static` **hasAsyncFeature**(`feature`): `boolean`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:388](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L388)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:576
 
 Checks if any registered function has a specific asynchronous feature.
 
@@ -3103,6 +3613,37 @@ Object to test.
 
 ***
 
+### isolateRegistry()
+
+> `static` **isolateRegistry**(`options?`): `void`
+
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:654
+
+Isolates the current registry layer by branching off its parent using prototype shadowing.
+
+This creates a new "scope" where:
+1. New registrations are stored only in the local layer, supporting tool shadowing.
+2. Parent tools remain accessible via the prototype chain (read-only) unless shadowed.
+3. Reference counting is isolated, enabling clean per-layer lifecycle management.
+
+#### Parameters
+
+##### options?
+
+[`ToolFuncRegistryIsolateOptions`](../interfaces/ToolFuncRegistryIsolateOptions.md)
+
+Options to selectively isolate specific maps (items, aliases, refCounts).
+
+#### Returns
+
+`void`
+
+#### Inherited from
+
+[`ResClientTools`](ResClientTools.md).[`isolateRegistry`](ResClientTools.md#isolateregistry)
+
+***
+
 ### isSealed()
 
 > `static` **isSealed**(`o`): `boolean`
@@ -3183,7 +3724,7 @@ Object that contains the properties and methods. This can be an object that you
 
 > `static` **list**(): [`Funcs`](../interfaces/Funcs.md)
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:331](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L331)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:558
 
 Returns the complete map of all registered functions.
 
@@ -3201,9 +3742,9 @@ The map of `ToolFunc` instances.
 
 ### loadFrom()
 
-> `static` **loadFrom**(`items?`): `Promise`\<[`Funcs`](../interfaces/Funcs.md)\>
+> `static` **loadFrom**(`items?`, `options?`): `Promise`\<[`Funcs`](../interfaces/Funcs.md)\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/client-tools.ts:69](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/client-tools.ts#L69)
+Defined in: @isdk/ai-tools/packages/tool-rpc/dist/index-359784IS.d.ts:235
 
 Loads tool definitions from the remote server via the configured transport.
 This method populates the local `ToolFunc` registry with `ClientTools` stubs.
@@ -3214,6 +3755,14 @@ This method populates the local `ToolFunc` registry with `ClientTools` stubs.
 
 [`Funcs`](../interfaces/Funcs.md)
 
+Optional map of tool function metadata.
+
+##### options?
+
+`any`
+
+Additional options for the discovery call (e.g., timeout).
+
 #### Returns
 
 `Promise`\<[`Funcs`](../interfaces/Funcs.md)\>
@@ -3228,7 +3777,7 @@ This method populates the local `ToolFunc` registry with `ClientTools` stubs.
 
 > `static` **loadFromSync**(`items`): `void`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/client-tools.ts:85](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/client-tools.ts#L85)
+Defined in: @isdk/ai-tools/packages/tool-rpc/dist/index-359784IS.d.ts:241
 
 Synchronously loads tool definitions from a provided object, registering
 each one as a `ClientTools` instance.
@@ -3289,9 +3838,24 @@ Object to make non-extensible.
 
 > `static` **register**(`name`, `options`): `boolean` \| [`ToolFunc`](ToolFunc.md)
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:495](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L495)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:718
+
+**`Internal`**
 
-Registers a new tool function.
+Registers a `ToolFunc` instance into the registry.
+
+This method supports multiple overloads and handles hierarchical registration,
+alias collision protection, and automatic dependency registration with cycle detection.
+
+### Hierarchical Behavior:
+- In an isolated registry, items are stored locally, shadowing parent items with the same name.
+- Alias consistency is enforced across the hierarchy: registering a colliding alias throws an error
+  unless `allowOverride.alias` is explicitly granted.
+
+### Circular Dependencies:
+Automatically detects and manages circular dependency chains using an internal stack.
+Reference counts are precisely managed (count=1 for back-edges) to prevent memory leaks
+and enable clean group unregistration.
 
 ##### Parameters
 
@@ -3299,19 +3863,38 @@ Registers a new tool function.
 
 `string`
 
-The name of the function.
+The tool instance, function, or name to register.
 
 ###### options
 
-[`FuncItem`](../interfaces/FuncItem.md)
+[`RegisterOptions`](../interfaces/RegisterOptions.md)
 
-The function's configuration.
+Configuration or implementation for the tool.
 
 ##### Returns
 
 `boolean` \| [`ToolFunc`](ToolFunc.md)
 
-The new `ToolFunc` instance, or `false` if a function with that name already exists.
+The registered ToolFunc instance on success (creation, shadowing, or override),
+or `false` if registration was ignored (e.g., ref-count increment only).
+
+##### Example
+
+```ts
+// 1. Registering with explicit name and function
+ToolFunc.register('add', { func: (a, b) => a + b });
+
+// 2. Registering with shadowing permission in an isolated registry
+MyPluginTools.register('calc', { func: () => 2 }, { allowOverride: true });
+
+// 3. Registering an existing ToolFunc instance
+const tool = new ToolFunc({ name: 'my-tool', func: () => 'ok' });
+ToolFunc.register(tool);
+```
+
+##### Throws
+
+If name is missing, or if an alias collision occurs without permission.
 
 ##### Inherited from
 
@@ -3321,9 +3904,24 @@ The new `ToolFunc` instance, or `false` if a function with that name already exi
 
 > `static` **register**(`func`, `options`): `boolean` \| [`ToolFunc`](ToolFunc.md)
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:496](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L496)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:719
+
+**`Internal`**
+
+Registers a `ToolFunc` instance into the registry.
+
+This method supports multiple overloads and handles hierarchical registration,
+alias collision protection, and automatic dependency registration with cycle detection.
 
-Registers a new tool function.
+### Hierarchical Behavior:
+- In an isolated registry, items are stored locally, shadowing parent items with the same name.
+- Alias consistency is enforced across the hierarchy: registering a colliding alias throws an error
+  unless `allowOverride.alias` is explicitly granted.
+
+### Circular Dependencies:
+Automatically detects and manages circular dependency chains using an internal stack.
+Reference counts are precisely managed (count=1 for back-edges) to prevent memory leaks
+and enable clean group unregistration.
 
 ##### Parameters
 
@@ -3331,19 +3929,36 @@ Registers a new tool function.
 
 `Function`
 
-The function implementation.
-
 ###### options
 
-[`FuncItem`](../interfaces/FuncItem.md)
+[`RegisterOptions`](../interfaces/RegisterOptions.md)
 
-The function's configuration.
+Configuration or implementation for the tool.
 
 ##### Returns
 
 `boolean` \| [`ToolFunc`](ToolFunc.md)
 
-The new `ToolFunc` instance, or `false` if a function with that name already exists.
+The registered ToolFunc instance on success (creation, shadowing, or override),
+or `false` if registration was ignored (e.g., ref-count increment only).
+
+##### Example
+
+```ts
+// 1. Registering with explicit name and function
+ToolFunc.register('add', { func: (a, b) => a + b });
+
+// 2. Registering with shadowing permission in an isolated registry
+MyPluginTools.register('calc', { func: () => 2 }, { allowOverride: true });
+
+// 3. Registering an existing ToolFunc instance
+const tool = new ToolFunc({ name: 'my-tool', func: () => 'ok' });
+ToolFunc.register(tool);
+```
+
+##### Throws
+
+If name is missing, or if an alias collision occurs without permission.
 
 ##### Inherited from
 
@@ -3351,31 +3966,71 @@ The new `ToolFunc` instance, or `false` if a function with that name already exi
 
 #### Call Signature
 
-> `static` **register**(`name`, `options?`): `boolean` \| [`ToolFunc`](ToolFunc.md)
+> `static` **register**(`name`, `options?`, `_stack?`): `boolean` \| [`ToolFunc`](ToolFunc.md)
+
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:720
+
+**`Internal`**
+
+Registers a `ToolFunc` instance into the registry.
+
+This method supports multiple overloads and handles hierarchical registration,
+alias collision protection, and automatic dependency registration with cycle detection.
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:497](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L497)
+### Hierarchical Behavior:
+- In an isolated registry, items are stored locally, shadowing parent items with the same name.
+- Alias consistency is enforced across the hierarchy: registering a colliding alias throws an error
+  unless `allowOverride.alias` is explicitly granted.
 
-Registers a new tool function.
+### Circular Dependencies:
+Automatically detects and manages circular dependency chains using an internal stack.
+Reference counts are precisely managed (count=1 for back-edges) to prevent memory leaks
+and enable clean group unregistration.
 
 ##### Parameters
 
 ###### name
 
-The name of the function.
+The tool instance, function, or name to register.
 
-`string` | `Function` | [`ToolFunc`](ToolFunc.md) | [`FuncItem`](../interfaces/FuncItem.md)
+`string` | `Function` | [`ToolFunc`](ToolFunc.md) | [`RegisterOptions`](../interfaces/RegisterOptions.md)
 
 ###### options?
 
-[`FuncItem`](../interfaces/FuncItem.md)
+[`RegisterOptions`](../interfaces/RegisterOptions.md)
+
+Configuration or implementation for the tool.
 
-The function's configuration.
+###### \_stack?
+
+`Set`\<`string`\>
+
+Used for cycle detection during recursive registration.
 
 ##### Returns
 
 `boolean` \| [`ToolFunc`](ToolFunc.md)
 
-The new `ToolFunc` instance, or `false` if a function with that name already exists.
+The registered ToolFunc instance on success (creation, shadowing, or override),
+or `false` if registration was ignored (e.g., ref-count increment only).
+
+##### Example
+
+```ts
+// 1. Registering with explicit name and function
+ToolFunc.register('add', { func: (a, b) => a + b });
+
+// 2. Registering with shadowing permission in an isolated registry
+MyPluginTools.register('calc', { func: () => 2 }, { allowOverride: true });
+
+// 3. Registering an existing ToolFunc instance
+const tool = new ToolFunc({ name: 'my-tool', func: () => 'ok' });
+ToolFunc.register(tool);
+```
+
+##### Throws
+
+If name is missing, or if an alias collision occurs without permission.
 
 ##### Inherited from
 
@@ -3385,12 +4040,15 @@ The new `ToolFunc` instance, or `false` if a function with that name already exi
 
 ### run()
 
-> `static` **run**(`name`, `params?`): `Promise`\<`any`\>
+> `static` **run**(`name`, `params?`, `ctx?`): `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:402](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L402)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:589
 
 Asynchronously executes a registered function by name with named parameters.
 
+Note: This method returns a `Promise` if the underlying function is asynchronous,
+otherwise it may return the result synchronously.
+
 #### Parameters
 
 ##### name
@@ -3405,11 +4063,17 @@ The name of the function to run.
 
 The parameters object for the function.
 
+##### ctx?
+
+[`ToolFuncContext`](../interfaces/ToolFuncContext.md)
+
+The execution context.
+
 #### Returns
 
-`Promise`\<`any`\>
+`any`
 
-A promise that resolves with the function's result.
+A promise or the direct result of the function's execution.
 
 #### Throws
 
@@ -3423,9 +4087,9 @@ If the function with the given name is not found.
 
 ### runSync()
 
-> `static` **runSync**(`name`, `params?`): `any`
+> `static` **runSync**(`name`, `params?`, `ctx?`): `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:417](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L417)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:598
 
 Synchronously executes a registered function by name with named parameters.
 
@@ -3443,6 +4107,12 @@ The name of the function to run.
 
 The parameters object for the function.
 
+##### ctx?
+
+[`ToolFuncContext`](../interfaces/ToolFuncContext.md)
+
+The execution context.
+
 #### Returns
 
 `any`
@@ -3461,12 +4131,15 @@ If the function with the given name is not found.
 
 ### runWithPos()
 
-> `static` **runWithPos**(`name`, ...`params`): `Promise`\<`any`\>
+> `static` **runWithPos**(`name`, ...`params`): `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:443](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L443)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:617
 
 Asynchronously executes a function using positional arguments.
 
+Note: This method returns a `Promise` if the underlying function is asynchronous,
+otherwise it may return the result synchronously.
+
 #### Parameters
 
 ##### name
@@ -3483,9 +4156,9 @@ Positional arguments to pass to the function.
 
 #### Returns
 
-`Promise`\<`any`\>
+`any`
 
-A promise that resolves with the function's result.
+A promise or the direct result of the function's execution.
 
 #### Throws
 
@@ -3501,7 +4174,7 @@ If the function with the given name is not found.
 
 > `static` **runWithPosSync**(`name`, ...`params`): `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:458](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L458)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:625
 
 Synchronously executes a function using positional arguments.
 
@@ -3587,7 +4260,7 @@ The object to change its prototype.
 
 The value of the new prototype or null.
 
-`null` | `object`
+`object` | `null`
 
 #### Returns
 
@@ -3603,7 +4276,7 @@ The value of the new prototype or null.
 
 > `static` **setPubSubTransport**(`t?`): `void`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event-client.ts:17](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/funcs/event-client.ts#L17)
+Defined in: @isdk/ai-tools/packages/tool-event/dist/index.d.ts:162
 
 #### Parameters
 
@@ -3621,7 +4294,7 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/funcs/event-client.ts:17](https
 
 > `static` **setTransport**(`transport`): `void`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/client-tools.ts:51](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/client-tools.ts#L51)
+Defined in: @isdk/ai-tools/packages/tool-rpc/dist/index-359784IS.d.ts:227
 
 Injects the client-side transport implementation. This is a crucial step
 to enable communication with the server.
@@ -3646,25 +4319,34 @@ The transport instance to use for all client-server communication.
 
 ### unregister()
 
-> `static` **unregister**(`name`): `undefined` \| [`ToolFunc`](ToolFunc.md)
+> `static` **unregister**(`target`, `options?`): [`ToolFunc`](ToolFunc.md) \| `undefined`
+
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:737
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/tool-func.ts:547](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/tool-func.ts#L547)
+Unregisters a tool function implementation from the registry by its name, alias, or instance.
 
-Unregisters a function by its name, also removing any associated aliases.
+This method supports hierarchical unregistration. If a function's reference count
+reaches zero, it is physically removed from the registry and its dependencies are released.
 
 #### Parameters
 
-##### name
+##### target
 
-`string`
+The name, alias, or implementation instance.
 
-The name of the function to unregister.
+`string` | [`ToolFunc`](ToolFunc.md)
+
+##### options?
+
+Options or a simple 'force' boolean flag.
+
+`boolean` | [`UnregisterOptions`](../interfaces/UnregisterOptions.md)
 
 #### Returns
 
-`undefined` \| [`ToolFunc`](ToolFunc.md)
+[`ToolFunc`](ToolFunc.md) \| `undefined`
 
-The unregistered `ToolFunc` instance, or `undefined` if it was not found.
+The unregistered ToolFunc instance, or `undefined` if not found.
 
 #### Inherited from
 
@@ -3725,3 +4407,31 @@ Object that contains the properties and methods. This can be an object that you
 ##### Inherited from
 
 [`ResClientTools`](ResClientTools.md).[`values`](ResClientTools.md#values)
+
+***
+
+### with()
+
+> `static` **with**(`ctx`): *typeof* [`ToolFunc`](ToolFunc.md)
+
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:515
+
+Returns a static proxy with the provided context.
+
+#### Parameters
+
+##### ctx
+
+[`ToolFuncContext`](../interfaces/ToolFuncContext.md)
+
+The context to use.
+
+#### Returns
+
+*typeof* [`ToolFunc`](ToolFunc.md)
+
+A static proxy of ToolFunc class.
+
+#### Inherited from
+
+[`ResClientTools`](ResClientTools.md).[`with`](ResClientTools.md#with-2)