@isdk/ai-tool 0.8.2 → 0.9.0

package/docs/api/interfaces/CmdArgAIChoiceConfig.md

@@ -0,0 +1,97 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / CmdArgAIChoiceConfig
+
+# Interface: CmdArgAIChoiceConfig
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:252](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L252)
+
+Configuration for AI selection logic (used by ChoiceArgProcessor).
+
+## Example
+
+```ts
+"|item1|item2:maxPick=2"
+```
+
+## Properties
+
+### end?
+
+> `optional` **end**: `string`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:268](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L268)
+
+Closing character/string for the selection UI
+
+***
+
+### items?
+
+> `optional` **items**: `string`[]
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:254](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L254)
+
+List of items to choose from
+
+***
+
+### maxPick?
+
+> `optional` **maxPick**: `number`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:256](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L256)
+
+Maximum number of items that can be picked
+
+***
+
+### minPick?
+
+> `optional` **minPick**: `number`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:258](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L258)
+
+Minimum number of items that must be picked
+
+***
+
+### prefix?
+
+> `optional` **prefix**: `string`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:262](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L262)
+
+Prefix to add to the result
+
+***
+
+### separator?
+
+> `optional` **separator**: `string`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:260](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L260)
+
+Separator for the resulting choice string
+
+***
+
+### suffix?
+
+> `optional` **suffix**: `string`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:264](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L264)
+
+Suffix to add to the result
+
+***
+
+### type?
+
+> `optional` **type**: `"ai"` \| `"random"`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:266](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L266)
+
+Selection strategy: 'random' for random pick, 'ai' for AI-assisted pick

package/docs/api/interfaces/CmdArgArgsInfo.md

@@ -0,0 +1,31 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / CmdArgArgsInfo
+
+# Interface: CmdArgArgsInfo
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:318](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L318)
+
+Normalized argument information, typically used for final consumption.
+
+## Properties
+
+### args
+
+> **args**: `any`[]
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:320](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L320)
+
+Positional arguments array
+
+***
+
+### namedArgs?
+
+> `optional` **namedArgs**: `Record`\<`string`, `any`\>
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:322](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L322)
+
+Named arguments map

package/docs/api/interfaces/CmdArgContext.md

@@ -0,0 +1,103 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / CmdArgContext
+
+# Interface: CmdArgContext
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:113](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L113)
+
+Symbol used to mark a result object returned by an ArgProcessor.
+...
+
+## Properties
+
+### CmdArgParser
+
+> **CmdArgParser**: [`CmdArgParser`](../classes/CmdArgParser.md)
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:134](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L134)
+
+Reference to the CmdArgParser instance for recursive parsing
+
+***
+
+### identifierAsName?
+
+> `optional` **identifierAsName**: `string`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:124](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L124)
+
+If the argument is positional and its raw text is a valid identifier,
+this holds that identifier name (used for auto-mapping).
+
+***
+
+### index
+
+> **index**: `number`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:128](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L128)
+
+The 0-based index of this argument in the positional sequence
+
+***
+
+### isNamed
+
+> **isNamed**: `boolean`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:115](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L115)
+
+True if the argument was explicitly assigned using an assigner (e.g., k=v)
+
+***
+
+### name?
+
+> `optional` **name**: `string`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:119](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L119)
+
+The explicitly specified name (k) in a `k=v` pair
+
+***
+
+### options
+
+> **options**: [`CmdArgParserOptions`](CmdArgParserOptions.md)
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:132](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L132)
+
+The configuration options used by the CmdArgParser
+
+***
+
+### rawValue
+
+> **rawValue**: `string`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:117](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L117)
+
+The raw input substring of this argument (after stripping the name and assigner if present)
+
+***
+
+### scope?
+
+> `optional` **scope**: `Record`\<`string`, `any`\>
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:130](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L130)
+
+The evaluation scope containing variables and functions
+
+***
+
+### tokens
+
+> **tokens**: [`CmdArgToken`](CmdArgToken.md)[]
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:126](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L126)
+
+All lexical tokens belonging to this argument

package/docs/api/interfaces/CmdArgFlagMetadata.md

@@ -0,0 +1,21 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / CmdArgFlagMetadata
+
+# Interface: CmdArgFlagMetadata
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:37](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L37)
+
+Metadata attached to flag values.
+
+## Properties
+
+### \[CMD\_ARG\_FLAG\_SYMBOL\]
+
+> **\[CMD\_ARG\_FLAG\_SYMBOL\]**: `string`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:39](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L39)
+
+The prefix used to define this flag (e.g., '!', '#')

package/docs/api/interfaces/CmdArgMapResult.md

@@ -0,0 +1,41 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / CmdArgMapResult
+
+# Interface: CmdArgMapResult
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:294](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L294)
+
+Result structure when mode is 'map'.
+
+## Properties
+
+### args
+
+> **args**: `any`[]
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:296](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L296)
+
+Positional arguments array
+
+***
+
+### flags?
+
+> `optional` **flags**: [`CmdArgFlagsRecord`](../type-aliases/CmdArgFlagsRecord.md)
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:300](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L300)
+
+Special parameters (Flags) map
+
+***
+
+### namedArgs
+
+> **namedArgs**: `Record`\<`string`, `any`\>
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:298](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L298)
+
+Named arguments map

package/docs/api/interfaces/CmdArgParseResult.md

@@ -0,0 +1,51 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / CmdArgParseResult
+
+# Interface: CmdArgParseResult
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:274](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L274)
+
+The internal structured result of the parsing process.
+
+## Properties
+
+### args
+
+> **args**: `any`[]
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:276](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L276)
+
+Positional arguments array. Indices correspond to the appearance order.
+
+***
+
+### flags
+
+> **flags**: [`CmdArgFlagsRecord`](../type-aliases/CmdArgFlagsRecord.md)
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:280](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L280)
+
+Special parameters (Flags) map. Values are usually Boolean but can be any type.
+
+***
+
+### namedArgs
+
+> **namedArgs**: `Record`\<`string`, `any`\>
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:278](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L278)
+
+Named arguments map, combining explicit `k=v`, auto-mapped IDs, and Processor results.
+
+***
+
+### namedIndices
+
+> **namedIndices**: `Set`\<`number`\>
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:282](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L282)
+
+A set of numeric indices that were populated by explicitly named arguments.

package/docs/api/interfaces/CmdArgParsedCommand.md

@@ -0,0 +1,41 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / CmdArgParsedCommand
+
+# Interface: CmdArgParsedCommand
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:306](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L306)
+
+The full structure of a parsed command.
+
+## Properties
+
+### args
+
+> **args**: `any`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:310](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L310)
+
+The parsed arguments, either simplified or in map format
+
+***
+
+### command
+
+> **command**: `string`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:308](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L308)
+
+The command name (the identifier before the parentheses)
+
+***
+
+### flags?
+
+> `optional` **flags**: [`CmdArgFlagsRecord`](../type-aliases/CmdArgFlagsRecord.md)
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:312](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L312)
+
+Special parameters (Flags) map (if present)

package/docs/api/interfaces/CmdArgParserOptions.md

@@ -0,0 +1,225 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / CmdArgParserOptions
+
+# Interface: CmdArgParserOptions
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:187](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L187)
+
+Configuration options for the CmdArgParser and main API functions.
+
+## Properties
+
+### argProcessor?
+
+> `optional` **argProcessor**: [`ArgProcessor`](../type-aliases/ArgProcessor.md)
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:206](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L206)
+
+Custom logic to process each argument before standard evaluation
+
+***
+
+### assigner?
+
+> `optional` **assigner**: `string`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:199](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L199)
+
+Character used for name-value assignment.
+
+#### Example
+
+```ts
+assigner: ':' -> "key:value"
+```
+
+#### Default
+
+```ts
+'='
+```
+
+***
+
+### delimiter?
+
+> `optional` **delimiter**: `string`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:193](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L193)
+
+Character used to separate arguments.
+
+#### Example
+
+```ts
+delimiter: ';' -> "arg1; arg2"
+```
+
+#### Default
+
+```ts
+','
+```
+
+***
+
+### excludeAutoNamedFromPositional?
+
+> `optional` **excludeAutoNamedFromPositional**: `boolean`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:218](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L218)
+
+If true, the positional index of an argument that has been automatically
+mapped as a named argument (via `idAsName`) will be excluded from the
+merged result object.
+
+#### Example
+
+```ts
+parse("John") -> {John: "John"} (instead of {0: "John", John: "John"})
+```
+
+***
+
+### flagPrefix?
+
+> `optional` **flagPrefix**: `string` \| `string`[]
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:204](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L204)
+
+Prefix(es) for special parameters (Flags).
+
+#### Example
+
+```ts
+flagPrefix: '!' -> "!debug, !verbose=false"
+```
+
+***
+
+### idAsName?
+
+> `optional` **idAsName**: `boolean`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:232](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L232)
+
+If true, a positional argument that is a valid identifier (e.g., "John")
+is automatically mapped as a named argument (e.g., {John: "John"}).
+
+#### Default
+
+```ts
+true
+```
+
+***
+
+### isInternal?
+
+> `optional` **isInternal**: `boolean`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:244](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L244)
+
+**`Internal`**
+
+Used to prevent infinite recursion in internal calls
+
+***
+
+### namedExcludePositional?
+
+> `optional` **namedExcludePositional**: `boolean`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:226](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L226)
+
+If true, explicitly named arguments (e.g., `k=v`) do not occupy a slot
+in the positional `args` array.
+
+#### Default
+
+```ts
+true
+```
+
+***
+
+### preserveUnresolvedName?
+
+> `optional` **preserveUnresolvedName**: `boolean`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:220](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L220)
+
+If true, return the variable name as a string when it's not found in scope instead of undefined
+
+***
+
+### raiseError?
+
+> `optional` **raiseError**: `boolean`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:238](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L238)
+
+If true, any parsing or evaluation error will be thrown
+
+***
+
+### raiseReferenceError?
+
+> `optional` **raiseReferenceError**: `boolean`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:240](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L240)
+
+If true, ReferenceErrors (missing variables) will be thrown. Defaults to `raiseError`.
+
+***
+
+### scope?
+
+> `optional` **scope**: `Record`\<`string`, `any`\>
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:242](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L242)
+
+An object containing variables accessible to expressions in the input string
+
+***
+
+### simplify?
+
+> `optional` **simplify**: `boolean` \| [`CmdArgSimplifyOptions`](CmdArgSimplifyOptions.md)
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:236](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L236)
+
+Control the simplification of the final result. Set to `false` to disable (returns a merged object).
+
+***
+
+### skipExpression?
+
+> `optional` **skipExpression**: `boolean`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:234](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L234)
+
+If true, JS expressions (like arithmetic or function calls) are not evaluated
+
+***
+
+### templateData?
+
+> `optional` **templateData**: `Record`\<`string`, `any`\>
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:210](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L210)
+
+Additional data for template variable substitution
+
+***
+
+### templateFormat?
+
+> `optional` **templateFormat**: `string`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:208](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L208)
+
+Format used by TemplateArgProcessor (e.g., 'mustache')

package/docs/api/interfaces/CmdArgProcessorResultOptions.md

@@ -0,0 +1,22 @@
+[**@isdk/ai-tool**](../README.md)
+
+***
+
+[@isdk/ai-tool](../globals.md) / CmdArgProcessorResultOptions
+
+# Interface: CmdArgProcessorResultOptions
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:99](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L99)
+
+Options for processors to control how the parsed value is distributed in the final result.
+
+## Properties
+
+### excludePositional?
+
+> `optional` **excludePositional**: `boolean`
+
+Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/command-parser/types.ts:104](https://github.com/isdk/ai-tool.js/blob/d10fb4cda65fc1975152a2c3ab327ecab008dea1/src/utils/command-parser/types.ts#L104)
+
+If true, the argument will be excluded from the positional `args` array.
+Useful when a positional argument is intended to be treated as a named parameter only.