fix: resolve biome lint errors in voltagent integration

Replace explicit `any` types with proper type annotations and fix
non-null assertion by using proper null checking.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: 2 people

packages/tools/src/voltagent/hooks.ts

@@ -10,7 +10,7 @@ import type {
 	HookPrepareMessagesArgs,
 	HookEndArgs,
 	VoltAgentMessage,
-	SupermemoryVoltAgentOptions,
+	SupermemoryVoltAgent,
 } from "./types"
 import {
 	createSupermemoryContext,
@@ -49,7 +49,7 @@ import {
  */
 export function createSupermemoryHooks(
 	containerTag: string,
-	options: SupermemoryVoltAgentOptions = {},
+	options: SupermemoryVoltAgent = {},
 ): VoltAgentHooks {
 	const ctx = createSupermemoryContext(containerTag, options)
 
@@ -60,7 +60,10 @@ export function createSupermemoryHooks(
 			try {
 				// VoltAgent passes user messages in args.context.input.messages
 				// and the prepared messages (system + conversation) in args.messages
-				const inputMessages = (args.context as any)?.input?.messages || []
+				const contextInput = args.context?.input as
+					| { messages?: VoltAgentMessage[] }
+					| undefined
+				const inputMessages = contextInput?.messages || []
 
 				ctx.logger.debug("onPrepareMessages called", {
 					messageCount: args.messages.length,
@@ -99,13 +102,19 @@ export function createSupermemoryHooks(
 				let messages: VoltAgentMessage[] = []
 
 				if (args.context?.input && args.output) {
-					const inputData = args.context.input as any
+					const inputData = args.context.input as
+						| { messages?: VoltAgentMessage[] }
+						| undefined
 					const inputMessages = inputData?.messages || []
 
-					const outputData = args.output as any
-					const outputText = typeof outputData === "string"
-						? outputData
-						: outputData?.text || outputData?.content
+					const outputData = args.output as
+						| string
+						| { text?: string; content?: string }
+						| undefined
+					const outputText =
+						typeof outputData === "string"
+							? outputData
+							: outputData?.text || outputData?.content
 
 					if (inputMessages.length > 0 && outputText) {
 						messages = [
@@ -158,7 +167,8 @@ export function mergeHooks(
 
 		mergedHooks.onPrepareMessages = async (args) => {
 			const resultAfterExisting = await existingOnPrepareMessages(args)
-			const messagesAfterExisting = resultAfterExisting?.messages || args.messages
+			const messagesAfterExisting =
+				resultAfterExisting?.messages || args.messages
 
 			return await supermemoryOnPrepareMessages({
 				...args,

packages/tools/src/voltagent/index.ts

@@ -9,10 +9,7 @@
 
 import { validateApiKey } from "../shared"
 import { createSupermemoryHooks, mergeHooks } from "./hooks"
-import type {
-	VoltAgentConfig,
-	SupermemoryVoltAgentOptions,
-} from "./types"
+import type { VoltAgentConfig, SupermemoryVoltAgent } from "./types"
 
 /**
  * Enhances a VoltAgent agent configuration with Supermemory memory capabilities.
@@ -139,7 +136,7 @@ import type {
  */
 export function withSupermemory<T extends VoltAgentConfig>(
 	config: T,
-	options: SupermemoryVoltAgentOptions & { containerTag: string },
+	options: SupermemoryVoltAgent & { containerTag: string },
 ): T {
 	const { containerTag, ...supermemoryOptions } = options
 
@@ -164,7 +161,7 @@ export function withSupermemory<T extends VoltAgentConfig>(
 
 // Export types for consumers
 export type {
-	SupermemoryVoltAgentOptions,
+	SupermemoryVoltAgent,
 	VoltAgentConfig,
 	VoltAgentMessage,
 	VoltAgentHooks,

packages/tools/src/voltagent/middleware.ts

@@ -18,10 +18,7 @@ import {
 	type Logger,
 	type MemoryMode,
 } from "../shared"
-import type {
-	SupermemoryVoltAgent,
-	VoltAgentMessage,
-} from "./types"
+import type { SupermemoryVoltAgent, VoltAgentMessage } from "./types"
 
 /**
  * Context for Supermemory middleware operations.
@@ -212,7 +209,11 @@ export const enhanceMessagesWithMemories = async (
 	const cachedMemories = ctx.memoryCache.get(turnKey)
 	if (!isNewTurn && cachedMemories) {
 		ctx.logger.debug("Using cached memories", { turnKey })
-		return injectMemoriesIntoMessages(messagesToEnhance, cachedMemories, ctx.logger)
+		return injectMemoriesIntoMessages(
+			messagesToEnhance,
+			cachedMemories,
+			ctx.logger,
+		)
 	}
 
 	ctx.logger.info("Starting memory search", {
@@ -277,8 +278,13 @@ export const enhanceMessagesWithMemories = async (
 
 		// Hybrid search returns both memory entries (`memory` field) and
 		// document chunks (`chunk` field). Handle both.
+		type SearchResult = {
+			memory?: string
+			chunk?: string
+			metadata?: Record<string, unknown>
+		}
 		const formattedMemories = response.results
-			.map((result: any) => {
+			.map((result: SearchResult) => {
 				const text = result.memory || result.chunk
 				return text ? `- ${text}` : null
 			})
@@ -289,7 +295,10 @@ export const enhanceMessagesWithMemories = async (
 			? ctx.promptTemplate({
 					userMemories: "",
 					generalSearchMemories: formattedMemories,
-					searchResults: response.results as any,
+					searchResults: response.results as Array<{
+						memory: string
+						metadata?: Record<string, unknown>
+					}>,
 				})
 			: `The following are relevant memories and context about this user retrieved from previous interactions. Use these to personalize your response:\n\n${formattedMemories}`
 	} else {
@@ -328,12 +337,20 @@ const injectMemoriesIntoMessages = (
 	if (systemMessageIndex !== -1) {
 		logger.debug("Added memories to existing system message")
 		const newMessages = [...messages]
-		const systemMessage = newMessages[systemMessageIndex]!
+		const systemMessage = newMessages[systemMessageIndex]
+		if (!systemMessage) {
+			return messages
+		}
 
 		// Extract existing text from parts (UIMessage format) or content fallback
-		const parts = (systemMessage as any).parts as Array<{ type: string; text?: string }> | undefined
+		const parts = (
+			systemMessage as { parts?: Array<{ type: string; text?: string }> }
+		).parts
 		const existingContent = parts
-			? parts.filter((p) => p.type === "text").map((p) => p.text || "").join("\n")
+			? parts
+					.filter((p) => p.type === "text")
+					.map((p) => p.text || "")
+					.join("\n")
 			: typeof systemMessage.content === "string"
 				? systemMessage.content
 				: ""
@@ -345,7 +362,7 @@ const injectMemoriesIntoMessages = (
 			content: newContent,
 			// Update parts array to match - this is what the LLM actually reads
 			parts: [{ type: "text", text: newContent }],
-		} as any
+		} as VoltAgentMessage
 		return newMessages
 	}
 
@@ -356,7 +373,7 @@ const injectMemoriesIntoMessages = (
 			role: "system" as const,
 			content: memories,
 			parts: [{ type: "text", text: memories }],
-		} as any,
+		} as VoltAgentMessage,
 		...messages,
 	]
 }

packages/tools/src/voltagent/types.ts

@@ -17,7 +17,8 @@ import type {
  * Configuration options for the Supermemory VoltAgent integration.
  * Extends base options with VoltAgent-specific settings.
  */
-export interface SupermemoryVoltAgentOptions extends Omit<SupermemoryBaseOptions, 'verbose'> {
+export interface SupermemoryVoltAgent
+	extends Omit<SupermemoryBaseOptions, "verbose"> {
 	/**
 	 * When using memory storage, set this to enable automatic conversation saving.
 	 * The threadId is used to group messages into a single conversation.
@@ -91,9 +92,7 @@ export interface SupermemoryVoltAgentOptions extends Omit<SupermemoryBaseOptions
 /**
  * Advanced search filters using AND/OR logic
  */
-export type SearchFilters =
-	| { OR: Array<unknown> }
-	| { AND: Array<unknown> }
+export type SearchFilters = { OR: Array<unknown> } | { AND: Array<unknown> }
 
 /**
  * Options for including additional data in search results
@@ -133,7 +132,9 @@ export interface IncludeOptions {
  */
 export interface VoltAgentMessage {
 	role: "system" | "user" | "assistant" | "tool"
-	content: string | Array<{ type: string; text?: string; [key: string]: unknown }>
+	content:
+		| string
+		| Array<{ type: string; text?: string; [key: string]: unknown }>
 	[key: string]: unknown
 }
 
@@ -158,7 +159,9 @@ export interface VoltAgentHooks {
 	onStart?: (args: HookStartArgs) => void | Promise<void>
 	onPrepareMessages?: (
 		args: HookPrepareMessagesArgs,
-	) => { messages?: VoltAgentMessage[] } | Promise<{ messages?: VoltAgentMessage[] }>
+	) =>
+		| { messages?: VoltAgentMessage[] }
+		| Promise<{ messages?: VoltAgentMessage[] }>
 	onEnd?: (args: HookEndArgs) => void | Promise<void>
 	[key: string]: unknown
 }
@@ -210,9 +213,4 @@ export interface HookEndArgs {
 }
 
 // Re-export shared types for convenience
-export type {
-	PromptTemplate,
-	MemoryMode,
-	AddMemoryMode,
-	MemoryPromptData,
-}
+export type { PromptTemplate, MemoryMode, AddMemoryMode, MemoryPromptData }