@isdk/ai-tool 0.8.2 → 0.9.0

package/docs/api/classes/ToolTransport.md

@@ -6,7 +6,7 @@
 
 # Abstract Class: ToolTransport
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/transports/base.ts:33](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/transports/base.ts#L33)
+Defined in: @isdk/ai-tools/packages/tool-rpc/dist/index-359784IS.d.ts:135
 
 ## Extended by
 
@@ -33,7 +33,7 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/transports/base.ts:33](https://
 
 > **apiRoot**: `string`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/transports/base.ts:34](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/transports/base.ts#L34)
+Defined in: @isdk/ai-tools/packages/tool-rpc/dist/index-359784IS.d.ts:136
 
 The root endpoint for the remote service.
 For HTTP, this is a URL. For IPC, it could be a channel name.
@@ -48,7 +48,7 @@ For HTTP, this is a URL. For IPC, it could be a channel name.
 
 > `optional` **options**: `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/transports/base.ts:36](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/transports/base.ts#L36)
+Defined in: @isdk/ai-tools/packages/tool-rpc/dist/index-359784IS.d.ts:138
 
 Additional options for the transport start or fetch, passed by mount.
 
@@ -62,7 +62,7 @@ Additional options for the transport start or fetch, passed by mount.
 
 > **Tools**: *typeof* [`ToolFunc`](ToolFunc.md)
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/transports/base.ts:35](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/transports/base.ts#L35)
+Defined in: @isdk/ai-tools/packages/tool-rpc/dist/index-359784IS.d.ts:137
 
 #### Implementation of
 
@@ -74,7 +74,7 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/transports/base.ts:35](https://
 
 > `abstract` **\_mount**(`Tools`, `apiRoot`, `options?`): `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/transports/base.ts:57](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/transports/base.ts#L57)
+Defined in: @isdk/ai-tools/packages/tool-rpc/dist/index-359784IS.d.ts:141
 
 #### Parameters
 
@@ -100,7 +100,7 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/transports/base.ts:57](https://
 
 > **mount**(`Tools`, `apiRoot?`, `options?`): `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/transports/base.ts:42](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/transports/base.ts#L42)
+Defined in: @isdk/ai-tools/packages/tool-rpc/dist/index-359784IS.d.ts:140
 
 #### Parameters
 
@@ -130,7 +130,7 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/transports/base.ts:42](https://
 
 > **setApiRoot**(`apiRoot`): `void`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/transports/base.ts:38](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/transports/base.ts#L38)
+Defined in: @isdk/ai-tools/packages/tool-rpc/dist/index-359784IS.d.ts:139
 
 #### Parameters
 

package/docs/api/classes/YamlTypeBaseObject.md

@@ -6,7 +6,7 @@
 
 # Class: YamlTypeBaseObject
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/yaml-type-base-object.ts:3](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/yaml-type-base-object.ts#L3)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/yaml-type-base-object.ts:3](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/yaml-type-base-object.ts#L3)
 
 ## Indexable
 
@@ -18,7 +18,7 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/yaml-type-base-object.ts:
 
 > **new YamlTypeBaseObject**(`options?`): `YamlTypeBaseObject`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/yaml-type-base-object.ts:5](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/yaml-type-base-object.ts#L5)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/yaml-type-base-object.ts:5](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/yaml-type-base-object.ts#L5)
 
 #### Parameters
 

package/docs/api/enumerations/AsyncFeatureBits.md

@@ -6,7 +6,7 @@
 
 # Enumeration: AsyncFeatureBits
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/cancelable-ability.ts:14](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/cancelable-ability.ts#L14)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:95
 
 ## Enumeration Members
 
@@ -14,7 +14,7 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/cancelable-ability.ts:14]
 
 > **Cancelable**: `1`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/cancelable-ability.ts:16](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/cancelable-ability.ts#L16)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:97
 
 ***
 
@@ -22,7 +22,7 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/cancelable-ability.ts:16]
 
 > **MultiTask**: `0`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/cancelable-ability.ts:15](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/cancelable-ability.ts#L15)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:96
 
 ***
 
@@ -30,4 +30,4 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/cancelable-ability.ts:15]
 
 > **Priority**: `2`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/cancelable-ability.ts:17](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/cancelable-ability.ts#L17)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:98

package/docs/api/enumerations/AsyncFeatures.md

@@ -6,7 +6,7 @@
 
 # Enumeration: AsyncFeatures
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/cancelable-ability.ts:21](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/cancelable-ability.ts#L21)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:100
 
 ## Enumeration Members
 
@@ -14,7 +14,7 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/cancelable-ability.ts:21]
 
 > **Cancelable**: `2`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/cancelable-ability.ts:23](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/cancelable-ability.ts#L23)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:102
 
 ***
 
@@ -22,7 +22,7 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/cancelable-ability.ts:23]
 
 > **MultiTask**: `1`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/cancelable-ability.ts:22](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/cancelable-ability.ts#L22)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:101
 
 ***
 
@@ -30,4 +30,4 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/cancelable-ability.ts:22]
 
 > **Priority**: `4`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/cancelable-ability.ts:24](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/cancelable-ability.ts#L24)
+Defined in: @isdk/ai-tools/packages/tool-func/dist/index.d.ts:103

package/docs/api/enumerations/CmdArgTokenType.md

@@ -0,0 +1,129 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / CmdArgTokenType
+
+# Enumeration: CmdArgTokenType
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:56](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L56)
+
+CmdArgToken types for lexical analysis.
+
+## Enumeration Members
+
+### ASSIGN
+
+> **ASSIGN**: `"ASSIGN"`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:61](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L61)
+
+Assignment operator (default: '=' or ':')
+
+***
+
+### COMMA
+
+> **COMMA**: `"COMMA"`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:59](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L59)
+
+Argument delimiter (default: ',')
+
+***
+
+### EOF
+
+> **EOF**: `"EOF"`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:57](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L57)
+
+***
+
+### IDENTIFIER
+
+> **IDENTIFIER**: `"IDENTIFIER"`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:77](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L77)
+
+Valid JS identifier (excluding reserved words like true/false)
+
+***
+
+### L\_BRACE
+
+> **L\_BRACE**: `"L_BRACE"`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:71](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L71)
+
+Left curly brace '{'
+
+***
+
+### L\_BRACKET
+
+> **L\_BRACKET**: `"L_BRACKET"`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:67](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L67)
+
+Left square bracket '['
+
+***
+
+### L\_PAREN
+
+> **L\_PAREN**: `"L_PAREN"`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:63](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L63)
+
+Left parenthesis '('
+
+***
+
+### R\_BRACE
+
+> **R\_BRACE**: `"R_BRACE"`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:73](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L73)
+
+Right curly brace '}'
+
+***
+
+### R\_BRACKET
+
+> **R\_BRACKET**: `"R_BRACKET"`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:69](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L69)
+
+Right square bracket ']'
+
+***
+
+### R\_PAREN
+
+> **R\_PAREN**: `"R_PAREN"`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:65](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L65)
+
+Right parenthesis ')'
+
+***
+
+### RAW
+
+> **RAW**: `"RAW"`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:79](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L79)
+
+Raw text segment, used for expressions or unquoted strings
+
+***
+
+### STRING
+
+> **STRING**: `"STRING"`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:75](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L75)
+
+Quoted string "..." or '...' or `...`

package/docs/api/enumerations/HashAlgorithm.md

@@ -6,7 +6,11 @@
 
 # Enumeration: HashAlgorithm
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/hash/const.ts:5](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/hash/const.ts#L5)
+Defined in: @isdk/ai-tools/packages/hash/dist/index.d.ts:41
+
+Enum representing the supported hashing algorithms.
+
+Each member is assigned a unique numeric value.
 
 ## Enumeration Members
 
@@ -14,7 +18,9 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/hash/const.ts:5](https://
 
 > **md5**: `1`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/hash/const.ts:6](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/hash/const.ts#L6)
+Defined in: @isdk/ai-tools/packages/hash/dist/index.d.ts:43
+
+MD5 (Message-Digest Algorithm 5)
 
 ***
 
@@ -22,7 +28,9 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/hash/const.ts:6](https://
 
 > **ripemd**: `3`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/hash/const.ts:8](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/hash/const.ts#L8)
+Defined in: @isdk/ai-tools/packages/hash/dist/index.d.ts:47
+
+RIPEMD-160 (RACE Integrity Primitives Evaluation Message Digest)
 
 ***
 
@@ -30,7 +38,9 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/hash/const.ts:8](https://
 
 > **sha1**: `2`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/hash/const.ts:7](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/hash/const.ts#L7)
+Defined in: @isdk/ai-tools/packages/hash/dist/index.d.ts:45
+
+SHA-1 (Secure Hash Algorithm 1)
 
 ***
 
@@ -38,7 +48,9 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/hash/const.ts:7](https://
 
 > **sha224**: `11`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/hash/const.ts:12](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/hash/const.ts#L12)
+Defined in: @isdk/ai-tools/packages/hash/dist/index.d.ts:55
+
+SHA-224 (Secure Hash Algorithm 224)
 
 ***
 
@@ -46,7 +58,9 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/hash/const.ts:12](https:/
 
 > **sha256**: `8`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/hash/const.ts:9](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/hash/const.ts#L9)
+Defined in: @isdk/ai-tools/packages/hash/dist/index.d.ts:49
+
+SHA-256 (Secure Hash Algorithm 256)
 
 ***
 
@@ -54,7 +68,9 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/hash/const.ts:9](https://
 
 > **sha384**: `9`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/hash/const.ts:10](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/hash/const.ts#L10)
+Defined in: @isdk/ai-tools/packages/hash/dist/index.d.ts:51
+
+SHA-384 (Secure Hash Algorithm 384)
 
 ***
 
@@ -62,7 +78,9 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/hash/const.ts:10](https:/
 
 > **sha512**: `10`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/hash/const.ts:11](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/hash/const.ts#L11)
+Defined in: @isdk/ai-tools/packages/hash/dist/index.d.ts:53
+
+SHA-512 (Secure Hash Algorithm 512)
 
 ***
 
@@ -70,7 +88,9 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/hash/const.ts:11](https:/
 
 > **xxhash**: `111`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/hash/const.ts:13](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/hash/const.ts#L13)
+Defined in: @isdk/ai-tools/packages/hash/dist/index.d.ts:57
+
+Generic XXHash (defaults to xxhash64 in some contexts)
 
 ***
 
@@ -78,7 +98,9 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/hash/const.ts:13](https:/
 
 > **xxhash128**: `113`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/hash/const.ts:16](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/hash/const.ts#L16)
+Defined in: @isdk/ai-tools/packages/hash/dist/index.d.ts:63
+
+XXHash128 (128-bit XXHash)
 
 ***
 
@@ -86,7 +108,9 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/hash/const.ts:16](https:/
 
 > **xxhash32**: `112`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/hash/const.ts:15](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/hash/const.ts#L15)
+Defined in: @isdk/ai-tools/packages/hash/dist/index.d.ts:61
+
+XXHash32 (32-bit XXHash)
 
 ***
 
@@ -94,4 +118,6 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/hash/const.ts:15](https:/
 
 > **xxhash64**: `111`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/hash/const.ts:14](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/hash/const.ts#L14)
+Defined in: @isdk/ai-tools/packages/hash/dist/index.d.ts:59
+
+XXHash64 (64-bit XXHash)

package/docs/api/functions/AIArgProcessor.md

@@ -6,28 +6,19 @@
 
 # Function: AIArgProcessor()
 
-> **AIArgProcessor**(`argInfo`, `ix`, `scope?`, `options?`): `Promise`\<`undefined` \| `string`\>
+> **AIArgProcessor**(`ctx`): `Promise`\<\{ `[CMD_ARG_PROCESSOR_RESULT]`: (`string` \| [`CmdArgAIChoiceConfig`](../interfaces/CmdArgAIChoiceConfig.md) \| \{ `excludePositional`: `boolean`; \})[]; \} \| `undefined`\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/parse-command.ts:187](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/parse-command.ts#L187)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/processors.ts:87](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/processors.ts#L87)
 
-## Parameters
-
-### argInfo
-
-`ArgInfo`
-
-### ix
+Combined AI processor (AIArgProcessor).
+Sequentially attempts choice selection and template variable processing.
 
-`number`
-
-### scope?
-
-`Record`\<`string`, `any`\>
+## Parameters
 
-### options?
+### ctx
 
-[`ParseObjectArgumentOptions`](../interfaces/ParseObjectArgumentOptions.md)
+[`CmdArgContext`](../interfaces/CmdArgContext.md)
 
 ## Returns
 
-`Promise`\<`undefined` \| `string`\>
+`Promise`\<\{ `[CMD_ARG_PROCESSOR_RESULT]`: (`string` \| [`CmdArgAIChoiceConfig`](../interfaces/CmdArgAIChoiceConfig.md) \| \{ `excludePositional`: `boolean`; \})[]; \} \| `undefined`\>

package/docs/api/functions/AIStream.md

@@ -8,7 +8,7 @@
 
 > **AIStream**\<`T`, `TOptions`\>(`response`, `customParser?`): `ReadableStream`\<[`AIResult`](../interfaces/AIResult.md)\<`T`, `TOptions`\>\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/stream/ai-stream.ts:120](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/stream/ai-stream.ts#L120)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/stream/ai-stream.ts:120](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/stream/ai-stream.ts#L120)
 
 Returns a ReadableStream created from the response, parsed and handled with custom logic.
 The stream goes through two transformation stages, first parsing the events and then

package/docs/api/functions/ChoiceArgProcessor.md

@@ -6,28 +6,26 @@
 
 # Function: ChoiceArgProcessor()
 
-> **ChoiceArgProcessor**(`argInfo`, `_ix`, `scope?`, `options?`): `undefined` \| `string`
+> **ChoiceArgProcessor**(`ctx`): `Promise`\<\{ `[CMD_ARG_PROCESSOR_RESULT]`: (`string` \| [`CmdArgAIChoiceConfig`](../interfaces/CmdArgAIChoiceConfig.md) \| \{ `excludePositional`: `boolean`; \})[]; \} \| `undefined`\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/parse-command.ts:155](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/parse-command.ts#L155)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/processors.ts:19](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/processors.ts#L19)
 
-## Parameters
-
-### argInfo
-
-`ArgInfo`
+Choice argument processor (ChoiceArgProcessor).
 
-### \_ix
+Syntax: |item1|item2:maxPick=2:separator=";"
 
-`number`
+Logic:
+1. Identifies positional arguments starting with '|'.
+2. Recursively uses the CmdArgParser to parse subsequent configuration items (delimited by ':').
+3. Constructs an CmdArgAIChoiceConfig object.
+4. Returns the result using the Symbol Protocol, named 'choice' and excluded from positional indexing.
 
-### scope?
-
-`Record`\<`string`, `any`\>
+## Parameters
 
-### options?
+### ctx
 
-[`ParseObjectArgumentOptions`](../interfaces/ParseObjectArgumentOptions.md)
+[`CmdArgContext`](../interfaces/CmdArgContext.md)
 
 ## Returns
 
-`undefined` \| `string`
+`Promise`\<\{ `[CMD_ARG_PROCESSOR_RESULT]`: (`string` \| [`CmdArgAIChoiceConfig`](../interfaces/CmdArgAIChoiceConfig.md) \| \{ `excludePositional`: `boolean`; \})[]; \} \| `undefined`\>

package/docs/api/functions/DefaultDateFormat.md

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

package/docs/api/functions/ObjectArgsToArgsInfo.md

@@ -6,9 +6,11 @@
 
 # Function: ObjectArgsToArgsInfo()
 
-> **ObjectArgsToArgsInfo**(`args`): `object`
+> **ObjectArgsToArgsInfo**(`args`): [`CmdArgArgsInfo`](../interfaces/CmdArgArgsInfo.md)
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/parse-command.ts:86](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/parse-command.ts#L86)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/api.ts:206](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/api.ts#L206)
+
+Normalizes various simplified result formats back into an `{args, namedArgs}` info structure.
 
 ## Parameters
 
@@ -18,12 +20,12 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/parse-command.ts:86](http
 
 ## Returns
 
-`object`
-
-### args
-
-> **args**: `any`[]
+[`CmdArgArgsInfo`](../interfaces/CmdArgArgsInfo.md)
 
-### kvArgs?
+## Example
 
-> `optional` **kvArgs**: `Record`\<`string`, `any`\>
+```ts
+ObjectArgsToArgsInfo("val") // returns {args: ["val"]}
+ObjectArgsToArgsInfo([1, 2]) // returns {args: [1, 2]}
+ObjectArgsToArgsInfo({name: "John"}) // returns {args: [], namedArgs: {name: "John"}}
+```

package/docs/api/functions/RateLimit.md

@@ -6,11 +6,13 @@
 
 # Function: RateLimit()
 
-> **RateLimit**(`rps`, `__namedParameters`): () => `Promise`\<`void`\>
+> **RateLimit**(`rps`, `options?`): () => `Promise`\<`void`\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:476](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/async-semaphore.ts#L476)
+Defined in: @isdk/util/dist/index.d.ts:976
 
-Creates a rate limiter function that blocks with a promise whenever the rate limit is hit and resolves the promise once the call rate is within the limit set by rps. The second argument is optional.
+创建一个速率限制器函数（Rate Limiter）。
+当调用频率超过设定的 `rps`（每秒请求数）时，该函数会通过 Promise 阻塞调用方，
+并在调用率回到限制范围内时解析。
 
 ## Parameters
 
@@ -18,18 +20,43 @@ Creates a rate limiter function that blocks with a promise whenever the rate lim
 
 `number`
 
-### \_\_namedParameters
+限制的速率。默认单位时间内允许的请求数。
+
+### options?
+
+配置项。
 
 #### timeUnit?
 
-`number` = `1000`
+`number`
+
+时间窗口大小（毫秒）。默认为 1000ms。
 
 #### uniformDistribution?
 
-`boolean` = `false`
+`boolean`
+
+是否强制离散均匀分布。
+   - 若为 `false`（默认）：允许在时间窗口开始时立即耗尽所有配额，然后暂停直到窗口结束。
+   - 若为 `true`：将配额均匀分配到时间窗口内（例如 5 rps 会每 200ms 允许一次请求）。
+     在流量持续且快速的场景下（如读取文件）建议开启，以避免瞬时突发流量。
 
 ## Returns
 
+返回一个异步限流函数，调用该函数即可实现限流。
+
+示例：
+```ts
+const lim = RateLimit(5); // 限制为 5 次/秒
+
+async function processItems(items) {
+  for (const item of items) {
+    await lim(); // 可能会在这里阻塞
+    await handle(item);
+  }
+}
+```
+
 > (): `Promise`\<`void`\>
 
 ### Returns

package/docs/api/functions/TemplateArgProcessor.md

@@ -6,28 +6,26 @@
 
 # Function: TemplateArgProcessor()
 
-> **TemplateArgProcessor**(`__namedParameters`, `ix`, `scope?`, `options?`): `Promise`\<`undefined` \| `string`\>
+> **TemplateArgProcessor**(`ctx`): `Promise`\<\{ `[CMD_ARG_PROCESSOR_RESULT]`: `any`[]; \} \| `undefined`\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/parse-command.ts:162](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/parse-command.ts#L162)
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/processors.ts:63](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/processors.ts#L63)
 
-## Parameters
-
-### \_\_namedParameters
-
-`ArgInfo`
+Template variable processor (TemplateArgProcessor).
 
-### ix
+Syntax: msg="Hello {{name}}"
 
-`number`
+Logic:
+1. Calls PromptTemplate.formatIf for variable substitution.
+2. If the substitution results in a bare string (no quotes and not JS literal source),
+   it is JSON-escaped to ensure it's recognized as a string literal in subsequent evaluation.
+3. Returns the substituted source string for re-evaluation by the Evaluator.
 
-### scope?
-
-`Record`\<`string`, `any`\>
+## Parameters
 
-### options?
+### ctx
 
-[`ParseObjectArgumentOptions`](../interfaces/ParseObjectArgumentOptions.md)
+[`CmdArgContext`](../interfaces/CmdArgContext.md)
 
 ## Returns
 
-`Promise`\<`undefined` \| `string`\>
+`Promise`\<\{ `[CMD_ARG_PROCESSOR_RESULT]`: `any`[]; \} \| `undefined`\>