@voltagent/core 0.1.7 → 0.1.8

package/dist/index.d.ts

@@ -2211,24 +2211,28 @@ declare const getNodeTypeFromNodeId: (nodeId: string) => NodeType | null;
 /**
  * Prompt management utilities for agent prompt tuning
  */
-/**
- * Type for prompt template variables
- */
-type PromptVariables = Record<string, string | number | boolean | undefined>;
-/**
- * Type for prompt template definition
- */
-type PromptTemplate = {
-    template: string;
-    variables?: PromptVariables;
+type ExtractVariableNames<T extends string> = T extends `${string}{{${infer Param}}}${infer Rest}` ? Param | ExtractVariableNames<Rest> : never;
+type AllowedVariableValue = string | number | boolean | undefined | null;
+type TemplateVariables<T extends string> = {
+    [K in ExtractVariableNames<T>]: AllowedVariableValue;
+};
+type PromptTemplate<T extends string> = [ExtractVariableNames<T>] extends [never] ? {
+    template: T;
+    variables?: Record<string, never>;
+} : {
+    template: T;
+    variables: TemplateVariables<T>;
 };
+type PromptCreator<T extends string> = (extraVariables?: Partial<TemplateVariables<T>>) => string;
 /**
- * Creates a customizable prompt from a template with variable placeholders
+ * Creates a type-safe, customizable prompt function from a template string.
+ * Variable names are automatically inferred from the template `{{variable}}` syntax.
  *
- * @param options - Template configuration with default variables
- * @returns Function that generates the prompt with provided variables
+ * @param template - The template string with `{{variable}}` placeholders.
+ * @param variables - An object containing the default values for the template variables.
+ * @returns A function that takes optional extra variables and returns the processed prompt string.
  */
-declare const createPrompt: (options: PromptTemplate) => (customVariables?: PromptVariables) => string;
+declare const createPrompt: <T extends string>({ template, variables, }: PromptTemplate<T>) => PromptCreator<T>;
 
 /**
  * Creates an AgentTool from a retriever, allowing it to be used as a tool in an agent.
@@ -2770,4 +2774,4 @@ declare class VoltAgent {
     getAgentCount(): number;
 }
 
-export { Agent, AgentHooks, AgentOptions, AgentRegistry, AgentResponse, AgentTool, AnyToolConfig, BaseLLMOptions, BaseMessage, BaseRetriever, BaseTool, BaseToolCall, ClientInfo, Conversation, CreateConversationInput, CreateReasoningToolsOptions, DEFAULT_INSTRUCTIONS, DataContent, FEW_SHOT_EXAMPLES, FilePart, GenerateObjectOptions, GenerateTextOptions, HTTPServerConfig, ImagePart, InMemoryStorage, InferGenerateObjectResponse, InferGenerateTextResponse, InferMessage, InferModel, InferProviderParams, InferStreamResponse, InferTool, LLMProvider, LibSQLStorage, MCPClient, MCPClientConfig, MCPClientEvents, MCPConfiguration, MCPOptions, MCPServerConfig, MCPToolCall, MCPToolResult, Memory, MemoryManager, MemoryMessage, MemoryOptions, MessageContent, MessageFilterOptions, MessageRole, ModelToolCall, NextAction, NodeType, PackageUpdateInfo, PromptTemplate, PromptVariables, ProviderObjectResponse, ProviderObjectStreamResponse, ProviderParams, ProviderResponse, ProviderTextResponse, ProviderTextStreamResponse, ReadableStreamType, ReasoningStep, ReasoningStepSchema, ReasoningToolExecuteOptions, Retriever, RetrieverOptions, RetryConfig, StdioServerConfig, StepChunkCallback, StepFinishCallback, StepWithContent, StreamObjectOptions, StreamTextOptions, TextPart, Tool, ToolCall, ToolExecuteOptions, ToolManager, ToolOptions, ToolSchema, ToolStatus, ToolStatusInfo, Toolkit, ToolsetMap, ToolsetWithTools, TransportError, UsageInfo, Voice, VoiceEventData, VoiceEventType, VoiceMetadata, VoiceOptions, VoltAgent, checkForUpdates, createHooks, createNodeId, createPrompt, createReasoningTools, createRetrieverTool, createTool, VoltAgent as default, getNodeTypeFromNodeId, tool, updateAllPackages, updateSinglePackage, zodSchemaToJsonUI };
+export { Agent, AgentHooks, AgentOptions, AgentRegistry, AgentResponse, AgentTool, AllowedVariableValue, AnyToolConfig, BaseLLMOptions, BaseMessage, BaseRetriever, BaseTool, BaseToolCall, ClientInfo, Conversation, CreateConversationInput, CreateReasoningToolsOptions, DEFAULT_INSTRUCTIONS, DataContent, ExtractVariableNames, FEW_SHOT_EXAMPLES, FilePart, GenerateObjectOptions, GenerateTextOptions, HTTPServerConfig, ImagePart, InMemoryStorage, InferGenerateObjectResponse, InferGenerateTextResponse, InferMessage, InferModel, InferProviderParams, InferStreamResponse, InferTool, LLMProvider, LibSQLStorage, MCPClient, MCPClientConfig, MCPClientEvents, MCPConfiguration, MCPOptions, MCPServerConfig, MCPToolCall, MCPToolResult, Memory, MemoryManager, MemoryMessage, MemoryOptions, MessageContent, MessageFilterOptions, MessageRole, ModelToolCall, NextAction, NodeType, PackageUpdateInfo, PromptCreator, PromptTemplate, ProviderObjectResponse, ProviderObjectStreamResponse, ProviderParams, ProviderResponse, ProviderTextResponse, ProviderTextStreamResponse, ReadableStreamType, ReasoningStep, ReasoningStepSchema, ReasoningToolExecuteOptions, Retriever, RetrieverOptions, RetryConfig, StdioServerConfig, StepChunkCallback, StepFinishCallback, StepWithContent, StreamObjectOptions, StreamTextOptions, TemplateVariables, TextPart, Tool, ToolCall, ToolExecuteOptions, ToolManager, ToolOptions, ToolSchema, ToolStatus, ToolStatusInfo, Toolkit, ToolsetMap, ToolsetWithTools, TransportError, UsageInfo, Voice, VoiceEventData, VoiceEventType, VoiceMetadata, VoiceOptions, VoltAgent, checkForUpdates, createHooks, createNodeId, createPrompt, createReasoningTools, createRetrieverTool, createTool, VoltAgent as default, getNodeTypeFromNodeId, tool, updateAllPackages, updateSinglePackage, zodSchemaToJsonUI };