@isdk/ai-tool 0.5.8 → 0.7.0

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

@@ -6,7 +6,34 @@
 
 # Class: PromptTemplate
 
-Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:20](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/prompt-template.ts#L20)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:50
+
+The `StringTemplate` class is a versatile template engine that supports dynamic template creation,
+formatting, and partial data processing. It extends the `BaseFactory` class and provides methods
+for handling template strings, validating input variables, and managing template configurations.
+
+## Example
+
+```typescript
+import { StringTemplate } from './template';
+
+// Register a custom template class
+class CustomTemplate extends StringTemplate {
+  _initialize(options?: StringTemplateOptions): void {}
+  _format(data: Record<string, any>): string {
+    return `Formatted: ${data.text}`;
+  }
+}
+StringTemplate.register(CustomTemplate);
+
+// Create a new instance with a custom template format
+const template = new StringTemplate("{{text}}", { templateFormat: "Custom" });
+console.log(template instanceof CustomTemplate); // Output: true
+
+// Format the template with data
+const result = await template.format({ text: "Hello World" });
+console.log(result); // Output: "Formatted: Hello World"
+```
 
 ## Extends
 
@@ -14,10 +41,9 @@ Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:20](https://gi
 
 ## Extended by
 
-- [`HfPromptTemplate`](HfPromptTemplate.md)
+- [`EnvPromptTemplate`](EnvPromptTemplate.md)
 - [`FStringPromptTemplate`](FStringPromptTemplate.md)
 - [`GolangPromptTemplate`](GolangPromptTemplate.md)
-- [`EnvPromptTemplate`](EnvPromptTemplate.md)
 - [`FewShotPromptTemplate`](FewShotPromptTemplate.md)
 
 ## Constructors
@@ -26,22 +52,38 @@ Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:20](https://gi
 
 > **new PromptTemplate**(`template`?, `options`?): [`PromptTemplate`](PromptTemplate.md)
 
-Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:69](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/prompt-template.ts#L69)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:187
+
+Initializes a new instance of the `StringTemplate` class.
 
 #### Parameters
 
 ##### template?
 
+Either a template string or an options object.
+
 `string` | [`PromptTemplateOptions`](../interfaces/PromptTemplateOptions.md)
 
 ##### options?
 
 [`PromptTemplateOptions`](../interfaces/PromptTemplateOptions.md)
 
+Additional configuration options for the template.
+
 #### Returns
 
 [`PromptTemplate`](PromptTemplate.md)
 
+#### Example
+
+```typescript
+const template = new StringTemplate("{{text}}", {
+  templateFormat: "Test",
+  inputVariables: ['text']
+});
+console.log(template instanceof TestStringTemplate); // Output: true
+```
+
 #### Overrides
 
 `BaseFactory.constructor`
@@ -52,7 +94,9 @@ Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:69](https://gi
 
 > **compiledTemplate**: `any`
 
-Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:21](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/prompt-template.ts#L21)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:54
+
+Declares the compiled template instance.
 
 ***
 
@@ -60,7 +104,9 @@ Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:21](https://gi
 
 > **data**: `undefined` \| `Record`\<`string`, `any`\>
 
-Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:24](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/prompt-template.ts#L24)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:66
+
+Declares the data object used for template interpolation.
 
 ***
 
@@ -68,7 +114,9 @@ Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:24](https://gi
 
 > **inputVariables**: `undefined` \| `string`[]
 
-Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:25](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/prompt-template.ts#L25)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:70
+
+Declares the list of input variables expected by the template.
 
 ***
 
@@ -76,7 +124,9 @@ Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:25](https://gi
 
 > **template**: `string`
 
-Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:22](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/prompt-template.ts#L22)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:58
+
+Declares the raw template string.
 
 ***
 
@@ -84,7 +134,9 @@ Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:22](https://gi
 
 > **templateFormat**: `undefined` \| `string`
 
-Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:23](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/prompt-template.ts#L23)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:62
+
+Declares the format of the template (e.g., 'default').
 
 ***
 
@@ -92,7 +144,7 @@ Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:23](https://gi
 
 > `abstract` `static` **\_aliases**: \[`string`\]
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:59
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:59
 
 **`Internal`**
 
@@ -109,7 +161,7 @@ the key is alias name, the value is the registered name
 
 > `static` **\_baseNameOnly**: `number`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:82
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:82
 
 **`Internal`**
 
@@ -150,7 +202,7 @@ _baseNameOnly
 
 > `abstract` `static` **\_children**: `object`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:49
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:49
 
 **`Internal`**
 
@@ -174,7 +226,7 @@ _children
 
 > `abstract` `static` **\_Factory**: *typeof* `BaseFactory`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:41
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:41
 
 **`Internal`**
 
@@ -196,7 +248,7 @@ _Factory
 
 > **get** `static` **aliases**(): `string`[]
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:200
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:200
 
 the aliases of itself
 
@@ -208,7 +260,7 @@ the aliases of itself
 
 > **set** `static` **aliases**(`value`): `void`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:196
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:196
 
 ##### Parameters
 
@@ -232,7 +284,7 @@ Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factor
 
 > **get** `static` **Factory**(): *typeof* `BaseFactory`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:63
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:63
 
 The Root Factory class
 
@@ -250,7 +302,9 @@ The Root Factory class
 
 > **\_format**(`data`): `string` \| `Promise`\<`string`\>
 
-Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:105](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/prompt-template.ts#L105)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:203
+
+Placeholder method for formatting the template. Must be implemented by subclasses.
 
 #### Parameters
 
@@ -258,17 +312,23 @@ Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:105](https://g
 
 `Record`\<`string`, `any`\>
 
+The data object used for interpolation.
+
 #### Returns
 
 `string` \| `Promise`\<`string`\>
 
+A formatted string or a promise resolving to the formatted string.
+
 ***
 
 ### \_initialize()
 
 > **\_initialize**(`options`?): `void`
 
-Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:92](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/prompt-template.ts#L92)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:192
+
+Placeholder method for initializing the template. Must be implemented by subclasses.
 
 #### Parameters
 
@@ -276,6 +336,8 @@ Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:92](https://gi
 
 [`PromptTemplateOptions`](../interfaces/PromptTemplateOptions.md)
 
+Configuration options for initialization.
+
 #### Returns
 
 `void`
@@ -286,9 +348,9 @@ Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:92](https://gi
 
 > **filterData**(`data`): `Record`\<`string`, `any`\>
 
-Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:62](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/prompt-template.ts#L62)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:172
 
-Validate/filter the data in inputVariables
+Filters the input data to include only the specified input variables.
 
 #### Parameters
 
@@ -296,17 +358,33 @@ Validate/filter the data in inputVariables
 
 `Record`\<`string`, `any`\>
 
+The data object to validate and filter.
+
 #### Returns
 
 `Record`\<`string`, `any`\>
 
+The filtered data object containing only the allowed keys.
+
+#### Example
+
+```typescript
+const template = new StringTemplate({
+  inputVariables: ['name']
+});
+const filteredData = template.filterData({ name: "Alice", age: 30 });
+console.log(filteredData); // Output: { name: "Alice" }
+```
+
 ***
 
 ### format()
 
 > **format**(`data`?): `Promise`\<`string`\>
 
-Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:109](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/prompt-template.ts#L109)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:219
+
+Formats the template using the provided data, supporting asynchronous processing.
 
 #### Parameters
 
@@ -314,21 +392,34 @@ Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:109](https://g
 
 `Record`\<`string`, `any`\>
 
+The data object used for interpolation.
+
 #### Returns
 
 `Promise`\<`string`\>
 
+A promise that resolves to the formatted template string.
+
+#### Example
+
+```typescript
+const template = new StringTemplate("{{text}}", {
+  templateFormat: "Test",
+  inputVariables: ['text']
+});
+const result = await template.format({ text: "Hello" });
+console.log(result); // Output: "Hello"
+```
+
 ***
 
 ### initialize()
 
-> `abstract` **initialize**(`options`?): `void`
-
-Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:96](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/prompt-template.ts#L96)
+> **initialize**(`options`?): `void`
 
-**`Internal`**
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:197
 
-initialize instance method
+Initializes the template instance with the provided options.
 
 #### Parameters
 
@@ -336,6 +427,8 @@ initialize instance method
 
 [`PromptTemplateOptions`](../interfaces/PromptTemplateOptions.md)
 
+Configuration options for initialization.
+
 #### Returns
 
 `void`
@@ -350,9 +443,10 @@ initialize instance method
 
 > **partial**(`data`): [`PromptTemplate`](PromptTemplate.md)
 
-Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:139](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/prompt-template.ts#L139)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:247
 
-it can make sense to "partial" a prompt template - eg pass in a subset of the required values, as to create a new prompt template which expects only the remaining subset of values.
+Creates a new `StringTemplate` instance with partially filled data.
+This is useful for pre-filling some variables while leaving others to be filled later.
 
 #### Parameters
 
@@ -360,39 +454,79 @@ it can make sense to "partial" a prompt template - eg pass in a subset of the re
 
 `Record`\<`string`, `any`\>
 
-the partial data
+The partial data to pre-fill in the new template.
 
 #### Returns
 
 [`PromptTemplate`](PromptTemplate.md)
 
-the new partial PromptTemplate instance
+A new `StringTemplate` instance with the partial data applied.
+
+#### Example
+
+```typescript
+const template = new StringTemplate("{{role}}:{{text}}", {
+  templateFormat: "Test",
+  inputVariables: ['role', 'text']
+});
+const partialTemplate = template.partial({ role: "user" });
+console.log(partialTemplate.data); // Output: { role: "user" }
+const result = await partialTemplate.format({ text: "Hello" });
+console.log(result); // Output: { role: "user", text: "Hello" }
+
+// Example with a function
+function getDate() {
+  return new Date();
+}
+const dateTemplate = template.partial({ date: getDate });
+console.log(dateTemplate.data); // Output: { date: getDate }
+const dateResult = await dateTemplate.format({ role: "user" });
+console.log(dateResult.date instanceof Date); // Output: true
+```
 
 ***
 
 ### toJSON()
 
-> **toJSON**(`options`): [`PromptTemplateOptions`](../interfaces/PromptTemplateOptions.md)
+> **toJSON**(`options`?): [`PromptTemplateOptions`](../interfaces/PromptTemplateOptions.md)
+
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:264
 
-Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:147](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/prompt-template.ts#L147)
+Serializes the `StringTemplate` instance into a JSON-compatible object.
 
 #### Parameters
 
-##### options
+##### options?
+
+[`PromptTemplateOptions`](../interfaces/PromptTemplateOptions.md)
 
-[`PromptTemplateOptions`](../interfaces/PromptTemplateOptions.md) = `...`
+Optional configuration for serialization.
 
 #### Returns
 
 [`PromptTemplateOptions`](../interfaces/PromptTemplateOptions.md)
 
+A JSON-compatible object representing the template's state.
+
+#### Example
+
+```typescript
+const template = new StringTemplate("{{text}}", {
+  templateFormat: "Test",
+  inputVariables: ['text']
+});
+const serialized = template.toJSON();
+console.log(serialized);
+// Output: { template: "{{text}}", templateFormat: "Test", inputVariables: ['text'] }
+```
+
 ***
 
 ### \_findRootFactory()
 
 > `static` **\_findRootFactory**(`aClass`): `undefined` \| *typeof* `BaseFactory`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:99
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:99
 
 **`Internal`**
 
@@ -420,7 +554,7 @@ the abstract root factory class
 
 > `static` **\_get**(`name`): `any`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:234
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:234
 
 #### Parameters
 
@@ -442,7 +576,7 @@ Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factor
 
 > `static` **\_register**(`aClass`, `aOptions`?): `boolean`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:145
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:145
 
 **`Internal`**
 
@@ -478,7 +612,7 @@ return true if successful.
 
 > `static` **cleanAliases**(`aName`): `void`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:162
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:162
 
 remove all aliases of the registered item or itself
 
@@ -504,7 +638,7 @@ the registered item or name
 
 > `static` **createObject**(`aName`, `aOptions`): `undefined` \| `BaseFactory`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:241
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:241
 
 Create a new object instance of Factory
 
@@ -532,7 +666,7 @@ Create a new object instance of Factory
 
 > `abstract` `static` **findRootFactory**(): `undefined` \| *typeof* `BaseFactory`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:92
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:92
 
 **`Internal`**
 
@@ -557,7 +691,7 @@ the root factory class
 
 > `static` **forEach**(`cb`): `any`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:227
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:227
 
 executes a provided callback function once for each registered element.
 
@@ -583,7 +717,9 @@ the forEach callback function
 
 > `static` **format**(`options`): `Promise`\<`string`\>
 
-Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:31](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/prompt-template.ts#L31)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:102
+
+Formats a template using the provided options.
 
 #### Parameters
 
@@ -591,19 +727,34 @@ Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:31](https://gi
 
 [`PromptTemplateOptions`](../interfaces/PromptTemplateOptions.md)
 
+Configuration options for the template.
+
 #### Returns
 
 `Promise`\<`string`\>
 
+A promise that resolves to the formatted template string.
+
+#### Example
+
+```typescript
+const result = await StringTemplate.format({
+  template: "{{text}}",
+  data: { text: "Hello" },
+  templateFormat: "Test"
+});
+console.log(result); // Output: "Hello"
+```
+
 ***
 
 ### formatIf()
 
 > `static` **formatIf**(`options`): `Promise`\<`undefined` \| `string`\>
 
-Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:41](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/prompt-template.ts#L41)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:118
 
-If the given options.template is the template, perform formatting using that template.
+Formats a template if the provided options represent a valid template.
 
 #### Parameters
 
@@ -611,13 +762,24 @@ If the given options.template is the template, perform formatting using that tem
 
 [`PromptTemplateOptions`](../interfaces/PromptTemplateOptions.md)
 
-The options object to check for being a template and to format.
+Configuration options to check and format.
 
 #### Returns
 
 `Promise`\<`undefined` \| `string`\>
 
-A Promise that resolves to the formatted result if options is a template; otherwise, no value is returned.
+A promise that resolves to the formatted template string if valid; otherwise, undefined.
+
+#### Example
+
+```typescript
+const result = await StringTemplate.formatIf({
+  template: "{{text}}",
+  data: { text: "Valid Template" },
+  templateFormat: "Test"
+});
+console.log(result); // Output: "Valid Template"
+```
 
 ***
 
@@ -625,7 +787,7 @@ A Promise that resolves to the formatted result if options is a template; otherw
 
 > `abstract` `static` **formatName**(`aName`): `string`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:116
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:116
 
 **`Internal`**
 
@@ -653,7 +815,7 @@ defaults to returning the name unchanged. By overloading this method, case-insen
 
 > `static` **formatNameFromClass**(`aClass`, `aBaseNameOnly`?): `string`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:130
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:130
 
 **`Internal`**
 
@@ -685,29 +847,47 @@ the name to register
 
 > `static` **from**(`template`?, `options`?): [`PromptTemplate`](PromptTemplate.md)
 
-Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:27](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/prompt-template.ts#L27)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:86
+
+Creates a new instance of the `StringTemplate` class.
 
 #### Parameters
 
 ##### template?
 
+Either a template string or an options object.
+
 `string` | [`PromptTemplateOptions`](../interfaces/PromptTemplateOptions.md)
 
 ##### options?
 
 [`PromptTemplateOptions`](../interfaces/PromptTemplateOptions.md)
 
+Additional configuration options for the template.
+
 #### Returns
 
 [`PromptTemplate`](PromptTemplate.md)
 
+A new `StringTemplate` instance.
+
+#### Example
+
+```typescript
+const template = StringTemplate.from("{{text}}", {
+  templateFormat: "Test",
+  inputVariables: ['text']
+});
+console.log(template instanceof TestStringTemplate); // Output: true
+```
+
 ***
 
 ### get()
 
 > `static` **get**(`name`): `undefined` \| *typeof* `BaseFactory`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:233
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:233
 
 Get the registered class via name
 
@@ -733,7 +913,7 @@ return the registered class if found the name
 
 > `static` **getAliases**(`aClass`): `string`[]
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:195
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:195
 
 get the aliases of the aClass
 
@@ -761,7 +941,7 @@ aliases
 
 > `static` **getDisplayName**(`aClass`): `undefined` \| `string`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:206
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:206
 
 Get the display name from aClass
 
@@ -787,7 +967,7 @@ the class, name or itself, means itself if no aClass
 
 > `static` **getNameFrom**(`aClass`): `string`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:122
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:122
 
 Get the unique(registered) name in the factory
 
@@ -813,7 +993,7 @@ the unique name in the factory
 
 > `static` **getRealName**(`name`): `any`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:100
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:100
 
 #### Parameters
 
@@ -835,7 +1015,7 @@ Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factor
 
 > `static` **getRealNameFromAlias**(`alias`): `undefined` \| `string`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:106
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:106
 
 get the unique name in the factory from an alias name
 
@@ -863,7 +1043,9 @@ the unique name in the factory
 
 > `static` **isTemplate**(`templateOpt`): `any`
 
-Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:48](https://github.com/isdk/ai-tool.js/blob/c084189f913fb955b91b492de68bd07ce78f8c82/src/utils/prompt/prompt-template.ts#L48)
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:133
+
+Determines whether the given options represent a valid template.
 
 #### Parameters
 
@@ -871,17 +1053,75 @@ Defined in: [packages/ai-tool/src/utils/prompt/prompt-template.ts:48](https://gi
 
 [`PromptTemplateOptions`](../interfaces/PromptTemplateOptions.md)
 
+The options object to evaluate.
+
 #### Returns
 
 `any`
 
+A boolean indicating whether the options represent a valid template.
+
+#### Example
+
+```typescript
+const isValid = StringTemplate.isTemplate({
+  template: "{{text}}",
+  templateFormat: "Test"
+});
+console.log(isValid); // Output: true
+```
+
+***
+
+### matchTemplateSegment()
+
+> `static` **matchTemplateSegment**(`templateOpt`, `index`?): `undefined` \| `RegExpExecArray`
+
+Defined in: @isdk/ai-tools/packages/template-engines/dist/index.d.ts:157
+
+Matches and extracts a single template segment from the provided template options.
+This method is designed to identify individual segments of a template string.
+
+#### Parameters
+
+##### templateOpt
+
+[`PromptTemplateOptions`](../interfaces/PromptTemplateOptions.md)
+
+The template options containing the template string and related configurations.
+
+##### index?
+
+`number`
+
+The default starting position in the template string to begin matching (default: 0).
+               This value is used only if `templateOpt.index` is not provided or invalid.
+
+#### Returns
+
+`undefined` \| `RegExpExecArray`
+
+A `RegExpExecArray` representing the matched template segment, or `undefined` if no match is found.
+         The `index` property of the result can be used to calculate the next position for iteration.
+
+#### Example
+
+```typescript
+const template = "{{name}} is {{age}} years old";
+let match = StringTemplate.matchTemplateSegment({ template });
+while (match) {
+  console.log(match[0]); // Output: "{{name}}"
+  match = StringTemplate.matchTemplateSegment({ template }, match.index + match[0].length);
+}
+```
+
 ***
 
 ### register()
 
 > `static` **register**(...`args`): `boolean`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:137
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:137
 
 register the aClass to the factory
 
@@ -907,7 +1147,7 @@ return true if successful.
 
 > `static` **registeredClass**(`aName`): `false` \| *typeof* `BaseFactory`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:151
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:151
 
 Check the name, alias or itself whether registered.
 
@@ -935,7 +1175,7 @@ the registered class if registered, otherwise returns false
 
 > `static` **removeAlias**(...`aliases`): `void`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:167
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:167
 
 remove specified aliases
 
@@ -961,7 +1201,7 @@ the aliases to remove
 
 > `static` **setAlias**(`aClass`, `alias`): `void`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:189
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:189
 
 set alias to a class
 
@@ -991,7 +1231,7 @@ the class to set alias
 
 > `static` **setAliases**(`aClass`, ...`aAliases`): `void`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:183
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:183
 
 set aliases to a class
 
@@ -1033,7 +1273,7 @@ import { BaseFactory } from 'custom-factory'
 
 > `static` **setDisplayName**(`aClass`, `aDisplayName`): `void`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:212
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:212
 
 Set the display name to the aClass
 
@@ -1065,7 +1305,7 @@ the display name to set
 
 > `static` **unregister**(`aName`): `boolean`
 
-Defined in: node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:157
+Defined in: @isdk/ai-tools/node\_modules/.pnpm/custom-factory@2.3.0/node\_modules/custom-factory/lib/base-factory.d.ts:157
 
 unregister this class in the factory